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王 硕 ， 网 名 信 平 ， 北 京 易 奢 拓 达 资 深 软 件 工程 师 ， 有 具有 8 年 Java 企 
业 应 用 开发 经 验 和 3 年 教育 培训 经 验 。 曾 主持 多 个 B/S 项 目的 开发 ， 经 验 
丰富 。 擅 长 J2EE (JSP/Servlet. JDBC. Struts 2、Spring、Hibernate) 应 
用 开发 、Python 数 据 分 析 、JavaScript、HTML 5 和 数据 库 技 术 ， 是 极 宽 
Top 开 源 团队 核心 成 员 。 








孙 洋 洋 ， 现 就 职 于 一 家 资产 管理 公司 ， 有 多 家 券商 工作 经 验 ， 负 责 
公司 量化 投 研 系统 的 开发 与 维护 ， 擅 长 网 络 爬 虫 、 机 器 学 习 、 程 序 GUI 
开发 与 设计 ， 对 量化 投资 领域 兴趣 浓厚 ， 有 多 年 量化 投资 实 盘 操作 经 
验 ， 是 极 宽 Top 开 源 团 队 核心 成 员 。 
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内 容 简 介 

本 书 既 是 介绍 PyQt 5 的 快速 入 门 书籍 ， 也 是 介绍 PyQt 5 实战 应 用 的 
书籍 。PyQt 5 是 对 Qt 所 有 类 的 Python 封装 ， 既 可 以 利用 Qt 的 强大 功能 ， 
也 可 以 利用 Python 丰富 的 生态 圈 ， 同 时 能 够 结合 Python 简洁 的 语法 进行 
操作 ， 其 结果 就 是 使 用 PyQt ”5 可 以 高 效 、 简 单 地 开发 出 自己 想 要 的 程 
序 。 本 书 内 容 丰 富 ， 对 PyQt 5 基础 知识 的 介绍 比较 全 面 ， 同 时 对 新 手 使 
用 PyQt 5 的 一 些 重 点 、 难 点 都 有 专门 的 章节 进行 针对 性 分 析 ， 还 重点 介 
绍 了 如 何 把 Python 的 一 些 重量 级 模块 〈Pandas、Matplotlib 和 Plotly) ik 
入 到 PyQt 5 中 ， 从 而 极 大 地 节约 开发 时 间 。 最 后 ， 本 书 给 出 一 些 综合 性 
较 强 的 实战 案例 ， 帮 助 读者 快速 掌握 PyQt 5 的 实战 应 用 。 

总 而 言 之 ， 本 书 旨 在 帮助 读者 以 最 短 的 时 间 掌 握 PyQt 5 的 基础 知识 
并 能 够 实战 上 应用， 希望 本 书 对 有 Python 程序 开发 需求 的 读者 有 帮助 。 

未 经 许可 ， 不 得 以 任何 方式 复制 或 抄袭 本 书 之 部 分 或 全 部 内 容 。 

版 权 所 有 ， 侵 权 必 究 。 
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MER: 5 年 股票 实 盘 经 验 ， 拥 有 证 券 从 业 资 格 证 书 、 基 金 从 业 资 
格 证 书 、 期 货 从 业 资 格 证 书 ， 通 过 期 货 投资 分 析 考 试 。 精 通 量 学 ， 擅 长 
多 空 对 比分 析 ， 对 多 空 趋势 平衡 有 独特 的 见解 ， 对 交易 心理 状况 有 深入 
的 研究 ， 擅 长 数据 分 析 ， 熟 悉 机 器 学 习 ， 精 通 Tensorflow、PyTorch， 擅 
长 Python 数据 分 析 。 

H: 管理 学 博士 ， 金 融 学 博士 后 ， 中 投 证 券 资 产 管理 部 投资 经 
理 ， 擅 长 量化 套利 策略 研究 与 交易 。 

RA: 智信 创 语 资产 管理 有 限 公 司 交 易 总 监 ， 擅 长 量化 投资 策略 构 
建 和 风险 控制 ， 对 市 场 行 情 走势 有 痢 精 准 的 判断 ， 实 盘 管 理 上 亿 资 产 。 

Me: 北 卡 罗 来 纳 大 学 教 竺 山 分 校 统计 运筹 学 硕士， 擅长 各 类 机 器 
学 习 模型 ， 有 多 年 数据 分 析 经 验 ， 并 且 熟 悉 网 站 架构 和 数据 可 视 化 。 

Bear: 饵 盛 华 股 份 有 限 公 司 量化 交易 员 ， 擅 长 时 间 序 列 分 析 、 机 
器 学 习 以 及 数据 挖掘 ， 有 多 年 量化 投资 实 盘 操作 经 验 ， 并 熟悉 Web 开 

陈 晓 楠 : 5 年 Python 开发 经 验 ， 精 通 Python 网 络 监控 、Python 自 动 化 
运营 和 Python 数 据 分 析 ， 有 10 年 以 上 的 网 络 服务 器 、 路 由 器 和 防火 墙 维 
护 经 验 ， 拥 有 思科 的 CCIE 证 书 。 

楚 建 欣 : 北京 交通 大 学 软件 工程 硕士 ， 有 20 年 IT 工 作 经 验 ， 曾 任 软 
件 开发 工程 师 、 测 斌 工程师、 项 目 经 理 、 测 试 部 门 经 理 ， 目 前 从 事 专业 
软件 测试 的 咨询 和 实施 工作 。 精 通 VBS、C#、Python、JavaScript。 拥 有 
ISTQB (国际 软件 测试 认证 〉。 























胡 乐 : 高 级 软件 工程 师 ， 有 10 多 年 的 工作 经 验 ， 精 通 Java、 
Python、Web 开 发 ， 擅 长 业务 分 析 ， 以 及 对 新 技术 的 研究 及 实践 ， 喜 爱 
开源 ， 热 爱 挑 战 自 我 ， 目 前 正在 研究 大 数据 、Drupal8 和 新 一 代 的 
CMS. 

IR: 现在 专职 炒股 。 有 18 年 炒股 经 验 、10 年 期 货 经验 。 精 通 缠 
论 、 波 浪 理论 。 在 缠 论 的 基础 上 ， 独 创 了 一 套 自己 的 炒股 实战 战 法 ， 兽 
在 2013 一 2015 年 实现 10 倍 的 收益 。 

张 剑 : 手 游 高 级 研发 工程 师 ， 有 3 年 产品 经 理 经 验 、 多 年 C++ 游戏 
开发 经 验 和 数据 分 析 经 验 。 熟 练 使 用 UE4、VS、Cocos2dx， 精 通 
C/C++、Python。 有 丰富 的 手 游 开 发 经 验 ， 目 前 研究 方向 是 手 游 开 发 和 
大 数据 。 

Ft: 兽 服务 于 Oracle 和 中 国 最 大 的 数据 库 公 司 TalkingData， 现 任 
量化 派 互 联网 高 级 运 维 研 发 工程 师 ， 有 丰富 的 服务 器 运 维 和 大 数据 相关 
工作 经 验 ， 目 前 研究 方向 是 大 数据 和 自动 化 运 维 。 

程 华 峰 :高 级 软件 工程 师 ， 数 据 库 系统 管理 员 ， 中 间 件 系统 开发 工 
程 师 。 一 直 致 力 于 软件 系统 的 研究 和 实践 ， 对 常用 的 软件 架构 产品 理论 
及 实践 都 有 透彻 的 研究 ， 总 结 出 丰富 的 实用 技术 。 领 导 并 负责 参与 完成 
多 项 大 型 复杂 项 目 ， 所 参与 开发 和 实施 的 项 目 涉及 教育 、 农 业 、 电 信和 
军工 等 相关 领域 。 既 通晓 软件 领域 相关 理论 和 新 技术 ， 又 具有 丰富 的 项 
目 经 验 。 

RS: 兽 服 务 于 和 久 游 游戏 和 中 国 移动 等 公司 ， 现 任 电信 集团 互联 网 
数据 挖掘 工程 师 ， 具 有 丰富 的 市 场 运营 和 数据 分 析 工 作 经 验 ， 能 准确 、 
有 效 地 定位 业务 问题 ， 精 通 数理 统计 和 常用 数据 挖掘 算法 ， 目 前 研究 方 
向 是 数据 挖掘 和 大 数据 ， 著 有 《游戏 数据 分 析 的 艺术 》。 

RR: 上 海 大 学 应 用 数学 专业 在 读 ，FRM Level I， 通 过 中 国 期 货 
投资 分 析 考 试 ， 擅 长 机 器 学 习 、 优 化 算法 与 CTA 策 略 开发 。 

Hii: 10 年 项 目 管理 及 产品 研发 经 验 ， 企 业 管 理 软件 业务 专家 ， 擅 
































长 新 技术 研究 及 落地 ， 目 前 研 客 方 同 为 机 需 学 习 技 术 及 区 块 链 技术 在 企 
业 管 理 过 程 中 的 应 用 。 


Python 可 以 说 是 世界 上 最 广泛 、 最 简单 的 编程 语言 之 一 ，Qt 可 以 说 
是 世界 上 最 好 的 程序 开发 库 之 一 。Python 与 Qt 结合 的 产物 就 是 PyQt， 
此 ，PyQt 束 成 了 Python 中 程序 开发 最 棒 的 库 之 一 〈 当 然 ， 笔 者 认为 它 在 
Python 程序 开发 中 就 是 最 棒 的 ) 。 由 于 PyQt 是 Python 与 Qt 的 结合 ， 所 以 
它 既 可 以 利用 Python 强大 而 又 简洁 的 语法 ， 又 不 会 丢失 Qt 强大 的 功能 。 
从 Python 的 角度 来 说 ， 凡 是 Python 涉及 的 所 有 简洁 、 易 用 性 的 语法 ， 
PyQt 都 可 以 使 用 ， 几 是 Python 涉 及 的 所 有 开源 模块 ，PyQt 也 都 可 以 使 
用 。 从 Qt 的 角度 来 说 ， 由 于 PyQt 完 成 了 对 Qt 的 所 有 类 的 封装 ， 因 此 ， 从 
理论 上 说 ， 使 用 Qt 能 开发 出 来 的 东西 ， 使 用 PyQt 也 可 以 开发 出 来 ， 
此 ，PyQt 可 以 利用 Qt 强大 的 功能 。 由 于 充分 利用 了 双方 的 优点 ， 所 以 
PyQt 在 开发 程序 的 过 程 中 会 带 来 一 些 意 想不到 的 收获 ， 利 用 Python 的 简 
洁 语法 与 强大 而 又 丰富 的 生态 圈 ， 有 些 程序 逻辑 在 Qt 中 实现 会 比较 复 
杂 ， 而 在 PyQt 中 却 很 简单 ， 这 才 是 PyQt 最 大 的 魅力 之 处 。 

近年 来 PyQt 发 展 很 快 ， 从 1998 年 最 初 的 PyQt 0.1， 到 PyQt 1、PyQt 
2、PyQt 3、PyQt 4 以 及 最 新 的 PyQt 5.9〈 和 截至 2017 年 8 月 9 日 ) ， 并 且 实 
现 了 PyQt 与 Qt 的 同步 更 新 。 有 一 点 非常 遗憾 的 是 ，PyQt 5 与 PyQt 4 并 不 
兼容 ，PyQt 4 的 代码 无 法 在 PyQt 5 中 运行 。PyQt 5 的 诞生 时 间 是 2013 年 4 
月 ， 至 今 ，PyQt 5 经 过 了 快速 发 展 ， 现 在 已 经 非常 成 熟 ， 并 且 Qt 开 发 团 
队 已 经 明确 宣布 从 2015 年 开始 就 放弃 了 对 Qt 4 〈 对 应 PyQt 4) 的 文 持 ， 
因此 ， 对 于 想 要 学 习 PyQt 的 朋友 来 说 ， 一 开始 就 学 习 PyQt 5 是 一 个 最 好 
的 选择 。 




















然而 ， 非 党 遗憾 的 是 ， 市 面 上 并 没有 一 本 真正 指导 新 手 学 习 PyQt 5 
的 教材 ， 网 络 上 针对 PyQt 5 的 学 习 案例 的 知识 结构 也 都 非常 零碎 ， 无 
法 形成 一 个 学 习 PyQt 5 的 系统 化 框架 。 因 此 ， 对 于 新 手 来 说 ， 想 要 快速 
接受 PyQt 5 系统 性 的 训练 是 一 件 非常 困难 的 事情 ， 笔 者 最 初学 习 PyQt 5 
的 时 候 也 吃 尽 了 苦头 ， 碍 阅 了 PyQt 5 与 Qt 5 的 大 量 官方 文献 资料 ， 并 结 
合 几 年 的 实战 应 用 之 后 ， 才 可 以 说 有 一 些 水 平 。 

编程 是 一 个 熟 能 生 巧 的 活 儿 ， 目 前 PyQt 5 的 开发 技术 算是 掌握 一 些 
了 ， 但 是 如 果 未 来 不 使 用 这 项 技术 ， 那 么 再 过 几 年 说 不 定 束 完全 瑟 记 
PyQt 5 是 如 何 使 用 的 了 ， 如 果 是 这 样 的 话 就 会 给 自己 留 下 一 些 遗 憾 。 考 
虑 到 现在 个 人 还 有 一 些 额 外 的 时 间 与 精力 ， 考 虑 到 目前 市 面 上 还 没有 一 
本 关于 PyQt 5 使 用 的 教材 ， 于 是 本 书 应 运 而 生 。 

写 书 是 一 项 神圣 而 又 艰辛 的 工作 ， 在 本 书 的 创作 期 间 ， 为 了 让 本 书 
包含 更 多 的 内 容 ， 同 时 又 让 其 变 得 更 容易 理解 ， 我 和 搭档 外 洋洋 查阅 了 
大 量 的 PyQt 5 官方 文献 资料 ， 花 费 了 很 大 的 时 间 和 精力 在 其 中 。 本 书 得 
以 顺利 出 版 ， 是 无 数 个 日 日 夜 夜 调试 和 写作 的 成 果 。 写 作 本 书 时 总 会 过 
到 一 些 复 末 的 PyQt ”5 技术 问题 ， 我 和 搭档 孙 洋 详 弟 关连 续 几 天 熬夜 讨 
论 ， 在 每 一 个 细节 上 反复 推 裔 ， 每 当 攻 克 技 术 难 点 的 时 候 ， 我 们 都 感到 
无 比 快乐 。 我 要 特别 感谢 搭档 孙 洋 洋 ， 没 有 你 的 坚持 和 或 励 ， 束 不 会 写 
出 这 么 精彩 的 书籍 ， 感 谢 你 那 较 真 的 性 格 ， 谢 谢 你 。 

经 过 近 一 年 的 不 懈 付 出 ， 这 本 介绍 PyQt 5 的 书 终于 出 版 了 ， 项 望 这 
本 书 可 以 帮助 更 多 的 朋友 掌握 PyQt 5 技术 ， 少 走 些 技术 弯路 。 同 时 这 本 
书 能 够 按时 出 版 ， 我 感到 无 比 欣 慰 ， 无 论 近 一 年 吃 了 多 少 苦 、 牺 牧 了 多 
少时 间 都 是 值得 的 。 

本 书 结构 

本 书 共有 11 革 ， 基 本 包含 了 笔者 在 使 用 PyQt 的 过 程 中 过 到 的 绝 大 多 
数 技术 及 一 些 经 典 的 应 用 。 书 中 有 些 章节 是 具有 独立 性 的 ， 读 者 可 以 针 
对 自己 的 实际 情况 选择 阅读 。 









































第 1 章 介绍 PyQt 的 入 门 知 识 ， 讲 述 PyQt 的 安装 配置 ， 以 及 Eric 6 这 个 
IDE 的 简单 使 用 方法 。 已 经 有 一 定 PyQt 基 础 的 朋友 可 以 略 去 这 一 章 。 

第 2 章 人 简单 介绍 Python 的 基本 语法 。 本 章 内 容 针对 一 些 没有 接触 过 
Python 的 读者 ， 已 经 有 一 些 Python 基 础 的 朋友 可 以 略 去 这 一 章 。 

第 3 章 介 绍 Qt Designer 的 使 用 方法 。Qt Designer 是 一 个 PyQt 的 可 视 
化 界面 编辑 程序 ， 它 的 作用 是 帮助 用 户 快 速 开发 出 界面 文件 ， 我 们 可 以 
通过 其 他 方式 把 界面 文件 转换 成 Python 代 码 文件 。 对 于 不 懂 太 多 PyQt 知 
识 的 读者 来 说 ， 本 章 内 容 可 以 让 你 快速 入 门 ， 同 时， 本 章 也 是 让 你 的 
PyQt 技 术 快 速 进步 的 最 午 要 章 市 。 

第 4 章 介绍 PyQt 5 的 基本 窗口 控件 的 使 用 方法 。 如 果 读 者 的 时 间 并 
不 充裕 ， 只 对 部 分 控件 感 兴趣 ， 则 可 以 选择 相应 的 小 节 阅 读 。 

第 5 章 介 绍 PyQt 5 的 高 级 界面 控件 的 使 用 方法 。 如 果 读 者 对 PyQt 的 
表格 、 树 、 容 器 (多 窗口 控件 ) 、 多 线程 等 感 兴趣 ， 则 可 以 选择 相应 的 
小 节 阅 读 。 

第 6 章 介 绍 PyQt 5 的 布局 管理 《在 第 3 章 中 阐述 Qt Designer 的 使 用 方 
法 时 已 经 做 了 介绍 ， 当 时 是 通过 Qt “Designer 这 个 代码 生成 堪 进 行 介绍 
的 ， 而 这 里 通过 手工 输入 代码 的 方法 进行 介绍 ) 。 由 于 布局 管理 非常 重 
要 ， 值 得 我 们 用 单独 一 章 来 介绍 。 如 果 读 者 对 用 纯 代 码 实现 布局 管理 器 
感 兴趣 ， 则 可 以 参考 这 一 章 ; 如 果 对 用 代码 生成 器 Qt Designer 实 现 布局 
管理 器 感 兴 趣 ， 则 可 以 忽略 这 个 章节 。 实 际 上 ， 这 两 种 方法 并 没有 本 质 
的 区 别 。 

第 7 章 介 绍 PyQt 5 信和 号 与 模 的 应 用 。 信 号 与 槽 是 PyQt 的 核心 ， 想 要 
掌握 PyQt 的 高 级 玩法 ， 则 可 以 仔细 阅读 这 个 章节 。 

第 8 章 介绍 PyQt 5 的 图 形 和 特效 。 本 章 内 容 适 用 于 有 PyQt 绘 图 、 美 
化 窗口 需求 的 读者 。 

第 9 章 介 绍 PyQt 5 的 扩展 应 用 。 如 果 你 想 知 道 如 何 把 Python 的 一 些 非 
常 流 行 的 模块 如 PyInstaller、Pandas、Matplotlib、PyQtGraph、Plotly 等 














与 PyQt 结 合 ， 则 可 以 选择 性 阅读 这 个 章节 。 

第 10 章 通过 几 个 例子 介绍 PyQt 5 的 实战 应 用 。 想 要 了 解 一 些 人 简单 的 
程序 是 如 何 开发 的 朋友 ， 则 可 以 选择 性 阅读 这 个 章 市 。 

第 11 章 介绍 PyQt 5 在 金融 领域 的 应 用 ， 这 是 本 书 作 者 孙 洋 洋 在 金融 
公司 工作 期 间 积累 的 一 些 实战 性 较 高 的 案例 ， 展 示 如 何 将 PyQRt 5 应 用 到 
投资 研究 系统 、 量 化 投资 以 及 金融 工具 开发 中 ， 读 者 可 以 根据 自己 的 需 
求 选 择 性 阅读 。 

本 书 附 赠 内 容 

附录 A: PyQt 5 整体 结构 

附录 B: Python 开发 技巧 与 实践 

附录 C: Python 在 线 学 习 资 料 

附 赠 内 容 保存 在 github 上 ， 网 址 是 : 
https://github.com/cxinping/PyQt5， 读 者 可 自行 下 载 。 视 读者 学 习 顺 利 、 
事业 有 成 。 

ARB 

本 书 适 合 具 有 Python 基础 的 读者 ， 通 过 本 书 可 熟悉 Python 基础 知识 
并 加 深 巩 回 。 本 书 结构 合理 ， 内 容 翔 实 ， 适 合 对 Python、Qt 和 PyQt 编 程 
感 兴趣 的 科教 人 员 和 广大 的 计算 机 编程 爱好 者 阅读 ， 也 可 作为 相关 机 构 
的 培训 教材 。 

致谢 

首先 ， 我 要 感谢 我 的 父亲。 在 我 上 大 学 期 间 由 于 家 性 变故 ， 我 的 父 
亲王 贵 诚 生 病 去 世 了 ， 这 对 我 打击 很 大 。 我 一 直 很 内 次 ， 在 他 走 之 前 ， 
没 能 见 上 他 最 后 一 面 。 在 最 后 一 次 谈话 中 ， 他 要 求 我 做 一 个 对 社会 有 用 
的 人 ， 实 现 上 自己 的 最 大 价值 ， 尽 目 己 的 所 能 无 私 地 帮助 别人 。 如 果 时 间 
可 以 倒流 ， 我 渴望 给 父 杀 一 个 拥抱 ， 对 他 说 :“ 我 明白 ， 一 代 人 做 一 代 
事 ”。 作 为 其 子 ， 我 愿意 为 您 分 忧 。 父 亲 教 会 我 人 生 的 意义 ， 让 我 懂得 
人 活着 束 要 做 有 意义 的 事情 ， 快 乐 地 过 每 一 天 。 我 爱 我 的 父亲 ， 我 爱 这 














。 谢 谢 父 杀 这 些 年 的 细心 教导 ， 让 我 懂得 生活 的 意义 。 谢 谢 您 ， 我 
FUR, FEEDS AN UM EE A HR, BT AA AE ER AR 
也 是 我 做 人 做 事 的 榜样 。 他 教会 我 作为 一 个 后 人 ， 应 该 有 的 尊严 和 骄 
做， 他 在 我 最 困难 的 时 候 给 予 我 无 私 的 帮助 ， 汞 励 我 退 寻 心中 的 梦想 。 
他 经 常 跟 我 说 , “一 生 之 计 在 于 勤 ， 一 天 之 计 在 于 晨 ”， 刚 开始 我 党 得 道 
理 浅 显 易 懂 ， 后 来 随 痢 年 龄 的 增长 、 社 会 阅历 的 增多 ， 才 逐渐 明白 ， 一 
个 人 只 有 付出 不 亚 于 任何 人 的 努力 ， 在 自己 的 领域 一 直 努 力 钻研 ， 锅 而 
不 舍 ， 才 能 成 功 。 这 个 道理 很 浅显 易 懂 ， 当 时 年 幼 不 觉得 如 何 有 用 ， 直 
至 今日 ， 方 才 明 白 是 至 理 名 言 。 
本 书 的 出 版 要 特别 感谢 电子 工业 出 版 社 的 黄 爱 萍 和 葛 娜 ， 感 谢 她 们 
在 选 题 策划 和 稿件 整理 方面 做 出 的 大 量 工作 。 
同时 ， 在 本 书 创作 过 程 中 ， 感 谢 编 委 会 的 全 体 成 员 ， 提 出 很 多 宝 贯 
的 意见 。 感 谢 编 委 会 的 邢 梦 来 ， 牺 牲 了 大 量 的 业余 时 间 ， 积 极 和 作者 讨 
论 写 书 细节 ， 校 对 了 全 部 课件 程序 ， 对 每 个 程序 都 做 了 中 文 注 解 。 
感谢 兄长 徐 楠 光 ， 教 会 我 用 感恩 的 心 去 工作 ， 积 极 主动 地 面 对 困 
难 ， 让 我 对 拥有 的 一 切 心怀 感激 。 
感谢 我 的 母亲 徐 素 萍 ， 感 谢 我 的 妻子 李 蔓 ， 感 谢 你 们 在 我 写 书 的 时 
候 给 我 提出 的 建议 ， 辟 励 我 写成 此 书 。 感 谢 母 亲 多 年 来 含 伴 如 兰 的 培 
养 ， 您 对 我 的 默默 文 持 ， 是 我 积极 向 上 的 精神 动力 。 
感谢 我 的 好 兄弟 王 祥 平 ， 在 本 书 的 出 版 过 程 中 提出 了 很 多 宝 贯 的 意 
见 。 在 我 心力 交 冶 时 ， 汞 励 我 永 不 放弃 ， 在 科大 学 习 期 间 是 我 一 生 中 最 
RRARW AF. 
感谢 我 的 师傅 张 云 河 ， 您 是 我 做 人 做 事 的 榜样 。 感 谢 您 教会 我 宝贵 
的 专业 知识 ， 在 我 最 沙 错 的 时 候 给 予 我 巨大 的 帮助 ， 让 我 有 能 力 去 实现 
自己 的 梦想 。 我 将 继续 追随 您 ， 为 梦想 而 努力 。 
感谢 潭 州 教育 的 众 位 老师 ，IOS 学 院 的 院 长 Dream 老 师 ，Python 学 院 























的 院 长 强 子 老师 ，Android 学 院 的 院 长 Hank 老 师 ， 教 会 我 专业 的 技术 ， 
使 我 的 技术 突 飞 狐 进 ， 还 或 励 我 要 为 社会 做 出 更 多 的 贡献 ， 实 现 目 己 的 
MAME 
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感谢 洛 基 英语 (Rocky English) 的 韩 宏 术 老师 、 查 理 老 师 和 刘 安 乐 
老师 ， 使 我 的 英语 水 平 得 到 提高 ， 让 我 掌握 了 地 道 、 流 利 、 准 确 的 英语 
发 音 ， 可 以 无 障碍 地 阅读 英文 技术 文档 。 给 予 我 信心 ， 帮 助 我 建立 人 生 
的 目标 和 梦想 。 

最 后 ， 特 别 感谢 克 亚 营销 的 刘 克 亚 老师 ， 拜 读 您 写 的 《 超 高 价 营 
销 》 时 ， 经 常 激动 得 彻夜 难 眠 ， 书 中 的 每 个 观点 都 让 我 兴奋 不 已 ，“ 一 
二 三 成 功 模式 ”更 是 坚定 我 写本 书 的 原因 ， 您 教导 我 要 先 无 私 地 给 予 别 
人 人， 帮助 别人 成 功 ， 然 后 自己 才能 成 功 ， 推 综 共 赢 而 不 是 竞争 。 作 为 您 
的 学 生 受 益 良 多 ， 您 提出 的 克 亚 营销 铁 律 ， 教 会 我 如 何 实现 自我 价值 。 
在 此 ， 让 我 怀 着 激动 的 心情 写 出 克 亚 营销 铁 律 。 

第 一 ， 你 的 所 有 营销 沟通 和 活动 ， 都 必须 100% 从 对 方 的 角度 思 
a 

第 二 ， 为 对 方 产生 结果 贡献 价值 ， 促 成 对 方 最 轻松 、 最 快速 地 实现 
梦想 ， 是 你 一 切 营销 的 终极 目标 。 

第 三 ， 你 必须 保证 结果 ， 提 供 零 风险 承诺 是 你 的 责任 ， 更 是 你 的 义 
务 。 

第 四 ， 你 永远 不 会 考虑 说 什么 才能 说 服 对方 ， 你 始终 问 自己 ，“ 给 
什么 才能 让 对 方 明白 购买 你 的 产品 或 服务 是 他 唯一 合理 的 选择 ”。 

第 五 ， 你 永远 不 会 等 到 对 方 购买 后 ， 才 开始 对 他 的 人 生 和 梦想 贡献 




















第 六 ， 你 永远 不 会 因为 对 方 已 经 购买 就 停止 对 他 的 人 生 和 梦想 贡献 


第 七 ， 你 为 对 方 创造 10 倍 的 价值 ， 才 索取 1 倍 的 回报 。 

第 八 ， 有 价值 的 教育 是 给 予 ， 也 是 贡献 。 

第 九 ， 你 必须 让 对 方 能 够 轻松 、 快 速 、 方 便 地 购买 和 使 用 你 的 产品 
或 服务 ， 并 从 中 受益 。 

第 十 ， 你 只 推崇 共 启 ， 从 不 相信 竞争 ， 在 你 的 书本 里 ， 当 创造 力 焊 
灭 的 时 候 ， 才 是 竞争 开始 的 时 候 。 

第 十 一 ， 你 必须 让 对 方 发 自 内 心地 感到 ， 认 识 你 并 和 你 交往 是 幸运 
的 ， 也 是 快乐 的 。 

第 十 二 ， 你 坚信 世界 上 最 自私 的 行为 是 无 私 。 

刘 克 亚 老师 的 克 亚 营销 思想 是 PC 互联 网 时 代 强 大 的 营销 利器 ， 更 
是 移动 互联 网 时 代 基 本 的 营销 必 备 工具 ， 因 为 它 的 理论 根植 于 人 性 的 基 
本 规律 和 商业 的 客观 规律 。 当 接触 元 亚 营 销 后 ， 我 才 明 白 如 何 打 造 出 爆 
款 产 品 ( 这 里 的 产品 指 一 切 可 以 销售 的 贡品， 软件 也 属于 商品 的 一 
种 ) 。 以 前 我 只 认识 到 软件 开发 的 重要 性 ， 但 接触 元 亚 营 销 后 才 发 现 ， 
最 重要 的 一 环 是 软件 销售 ， 只 有 销售 成 功 了 ， 才 能 为 企业 融 来 足够 的 利 
润 ， 企 业 才 有 能 力 继续 维护 和 开发 下 一 版 软件 ， 进 入 民 性 循环 中 ， 这 种 
软件 才 可 以 称 得 上 是 成 功 的 软件 。 所 以 ， 我 以 此 书 癌 刘 殉 亚 老师 致敬 ， 
谢谢 您 。 

轻松 注册 成 为 博文 视点 社区 用 户 (www.broadview.com.cn) , F443 
直达 本 书页 面 。 

e 下 载 资 源 : 本 书 所 提供 的 示例 代码 及 资源 文件 ， 均 可 在 下 载 资 
源 处 下 载 。 

e 提交 勘误 : 您 对 书 中 内 容 的 修改 意见 可 在 提交 勘误 MER, A 
被 采纳 ， 将 获 赠 博 文 视点 社区 积分 (在 您 购买 电子 书 时 ， 积 分 可 用 来 抵 
扣 相 应 金额 〉。 

e 交流 互动 : FER RA 读者 评论 处 留 下 您 的 疑问 或 观点 ， 与 我 
们 和 其 他 读者 一 同学 习 交 流 。 























页 面 入 口 : http:/www.broadview.com.cn/32291 
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.3 MatplotlibWidget 的 使 









第 1 章 认识 PyQt5 


1.1 PvaQt 框 加 简介 





在 目前 的 软件 设计 过 程 中 ， 图 形 用 户 界 面 《GUI) 的 设计 相当 重 
要 ， 美 观 、 吻 用 的 用 户 界面 能 够 在 很 大 程度 上 提高 软件 的 使 用 量 ， 因 此 
许多 软件 都 在 用 户 界面 上 倾注 了 大 量 的 精力 。 

在 介绍 PyQt 框 架 之 前 ， 我 们 先 来 了 解 什么 是 图 形 用 户 界 面 
(GUD 。 

百度 百科 : GUI 词 条 

GUI 是 Graphical User Interface 的 英文 简称 ， 即 图 形 用 户 界面 ， 准 确 
地 说 ，GUI 就 是 屏幕 产品 的 视觉 体验 和 互动 操作 部 分 。GUI 是 一 种 结合 
计算 机 科学 、 美 学 、 心 理学 、 行 为 学 及 各 商业 领域 需求 分 析 的 人 机 系统 
工程 ， 强 调 人 一 机 一 环境 三 者 作为 一 个 系统 进行 总 体 设 计 。 

Python 最 初 是 作为 一 门 脚 本 语言 开发 的 ， 并 不 具备 GUI 功能 ， 但 由 
于 其 本 身 具 有 恨 好 的 可 扩展 性 ， 能 够 不 断 地 通过 C/C++ 模块 进行 功能 性 
扩展 ， 因 此 目前 已 经 有 相当 多 的 GUI 控 件 集 (Toolkit) 可 以 在 Python 中 
使 用 了 。 

在 Python 中 经 常 使 用 的 GUI 控 件 集 有 PyQt、Tkinter、wxPython、 
Kivy、PyGUI 和 Libavg， 其 中 PyQt 是 Qt 为 Python 专门 提供 的 GUI 扩展 。 

百度 百科 : PyQt 词 条 

PyQt 是 一 个 用 于 创建 GUI 应 用 程序 的 跨 平台 的 工具 包 ， 它 将 Python 

















编程 语言 和 Qt 库 成 功 融 合 在 一 起 。Qt 库 是 目前 最 强大 的 GUI 库 之 一 。 

PyQt 是 由 Phil Thompson 开发 的 ， 实 现 了 一 个 Python 模块 集 。PyQt 
拥有 620 多 个 类 、 将 近 6000 个 函数 。PyQt 可 以 运行 在 所 有 主流 的 操作 系 
统 上 ， 包 括 UNIX、Windows 和 Mac OS。PyQt 采 用 双 许 可 证 ， 开 发 人 员 
可 以 选择 GPL 和 商业 许可 。 在 此 之 前 ，GPL 版 本 只 能 用 在 UNIX 上 ; 从 
PyQt4 开 始 ，GPL 版 本 可 用 于 所 有 支持 的 平台 上 。 

访问 PyQt 5 的 官方 网 站 : https:/www.riverbankcomputing.com/， 如 
图 1-1 所 示 。 截 至 本 书 成 书 之 时 ，PyQt 的 最 新 版 本 是 5.9。PyQt 是 Python 
下 的 一 套图 形 用 户 界 面 库 ， 可 以 在 Python 中 调用 Qt 的 图 形 库 和 控件 。 
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What is PyQt? 


Recent news 
PyQt is a set of Python v2 and v3 bindings for The Qt any's Qt application framework and runs on all platforms supported by Qt including Windows, OS X, 
Linux, iOS and Android. PyQt5 supports Qt v5. PyQt4 polka Qt v4 and will build against Qt v5. The bindings are implemented as a set of Python modules and PyQt v5.9 Released 
contain over 1,000 classes. SIP v4.19.3 Released 


QScintilla v2.10.1 Release 
PyQt 4.12.1 Released 
PyQt v5.6.2 Released 


The Qt Company no longer supports Qt v4. PyQt5 and Qt v5 are strongly recommended for all new development. 


PyQt is dual licensed on all supported platforms under the GNU GPL v3 and the Riverbank Commercial License. Unlike at PyQt is not available under the LGPL 
You can purchase the commercial version of PyQt here. More information about licensing can be found in the Li 


PyQt does not include a copy of Qt. You must obtain a correctly licensed copy of Qt yourself. However, binary wheels of the GPL version of PyQt5 are provided 
and these include a copy of the LGPL version of Qt. 


PyQt Components 
A description of the components of PyQt5 can be found in the PyQt5 Reference Guide 
A description of the components of PyQt4 can be found in the PyQt4 Reference Guide 


Why PyQt? 


PyQt brings together the Qt C++ cross-platform application framework and the cross-platform interpreted language Pyth 











Qt is more than a GUI toolkit. It includes abstractions of network sockets, threads, Unicode, regular expressions, SQL databases, SVG, OpenGL, XML, a fully 


图 1-1 





Qt 是 挪威 Trolltech 〈 奇 趣 科 技 公 司 ) 开发 的 一 个 C++ GUI 应 用 程 
序 ， 其 包括 跨 平台 类 库 、 集 成 开发 工具 和 跨 平 台 IDE， 既 可 以 用 于 开发 
GUI 程序 ， 也 可 以 用 于 开发 非 GUI 程序 。 使 用 Qt 只 需 开 发 一 次 应 用 程 
序 ， 便 可 器 不 同 果 面 和 磐 入 式 操 作 系 统 部 署 该 应 用 程序 ， 而 无 顷 重 新 编 
写 源 代码 。 和 Python 一 样 ，Qt 也 具有 相当 优秀 的 路 平台 特性 ， 使 用 Qt 开 








发 的 应 用 程序 能 够 在 Windows、Linux 和 Mac OS 平台 之 间 轻 松 移植 。 

2008 年 6 月 ，Trolltech 被 Nokia《〈 诺 基 亚 ) 收购 ，Qt 也 因此 成 为 诺 基 
亚 旗下 的 编程 语言 工具 ，2012 年 8 月 ，Qt 业 务 又 被 分 兰 开业 务 供应 商 
Digia 从 诺基亚 手中 全 面 收购 。 现 在 的 Qt 既 有 开源 版 本 ， 也 有 商业 版 
本 ，Digia 通过 开源 授权 (LGPL 和 GPL) 以 及 商业 授权 的 方式 对 Qt 进行 
授权 。 

开源 软件 需要 解决 的 最 大 问题 是 如 何 处 理 开发 者 使 用 开源 软件 来 完 
成 个 人 或 商业 目标 的 情况 ， 其 中 包括 版 权 与 收益 的 问题 。 当 一 个 软件 开 
发 者 打算 将 自己 写 的 代码 开源 时 ， 通 常 选 择 自 由 软件 协议 ， 即 
GPL (GNU General Public License，GNU 通 用 公共 许可 证 ) 。 因 此 ， 
PyQt 5 选择 了 GPL 协议 ， 所 以 开发 者 可 以 放心 使 用 PyQt 5 开发 软件 。 

GPL 协议 : 软件 版 权 属 于 开发 者 本 人 ， 软 件 产品 受 国际 相关 版 权 法 
的 保护 。 人 允许 其 他 用 户 对 原作 者 的 软件 进行 复制 或 有 发行， 并 且 可 以 在 更 
改 之 后 发 行 自 己 的 软件 。 但 新 软件 在 发 布 时 也 必须 遵守 GPL 协议 ， 不 得 
对 其 进行 其 他 附加 的 限制 。 在 GPL 下 不 存在 “盗版 ”一 说 ， 但 用 户 不 能 将 
软件 据 为 已 有 ， 比 如 申请 软件 产品 “专利 ”等 ， 因 为 这 将 违反 GPL 协 议 并 
且 侵 犯 了 原作 者 的 版 权 。 

目前 ，PyQt 官 网 提供 了 PyQt 4 和 PyQt 5 两 种 版 本 的 文档 说 明 。 本 书 
主要 以 PyQt 5 为 例 进 行 讲 解 。 














1.1.1 PyQt 5 的 特点 


自从 Qt 移植 到 Python 上 形成 PyQt 框 架 以 来 ， 己 开发 出 PyQt 3、PyQt 
4 和 PyQt 5 三 个 版 本 。PyQt 于 1998 年 首次 发 布 ， 当 时 名 字 叫 PyKDE, 
如 今 改 名 为 PyQt 并 提供 GPL 版 和 商业 版 。 

注意 


PyQt 5 严格 遵循 Qt 的 发 布 许可 ， 拥 有 双重 协议 ， 目 由 开发 者 可 以 选 


择 使 用 人 免费 的 GPL 版 本 ， 如 果 准 备 将 PyQt 用 于 商业 活动 ， 则 必须 为 此 交 
付 商 业 许 可 费用 。 

最 后 ， 让 我 们 来 看 看 Qt 官网 (https://www.qt.io/cn/〉 上 的 官方 宣传 
壁纸 ， 如 图 1-2 所 示 ， 答 案 就 在 其 中 。 
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图 1-2 


《财富 》 全 球 500 强 企业 中 的 前 10 家 企业 ， 有 8 家 在 使 用 Qt 开发 软 
件 ， 如 图 1-3 所 示 。 


《财富 》 全 球 500 强 企业 中 的 前 10 家 企业 ， 有 8 家 使 用 Qt 


Qt 帮助 您 更 快 、 更 曾 能 地 创建 设备 、UI 及 跨 屏 应 用 。 





图 1-3 


PyQt 下 受到 越 来 越 多 的 Python 程 序 员 的 喜爱 ， 这 是 因为 PyQt 上 共有 如 
下 优秀 的 特性 。 
o 基于 高 性 能 的 Qt 的 GUI 控件 集 。 
e 能 够 跨 平 台 运 行 在 Windows、Linux 和 Mac OS 等 系统 上 。 


o 使 用 信号 / 柳 Csignal/slot) 机制 进行 通信 。 

© 对 Qt 库 的 完全 封装 。 

o 可 以 使 用 Qt 成 熟 的 IDE (如 Qt Designer) 进行 图 形 界面 设计 ， 并 
自动 生成 可 执行 的 Python 代码 。 

o 提供 了 一 整套 种 类 繁多 的 窗口 控件 。 








1.1.2 QtS5SPyQtH2 


首先 ，PyQt 是 Qt 框架 的 Python 语 言 实 现 。PyQt 提 供 了 一 个 设计 良好 
的 窗口 控件 集合 ， 每 一 个 PyQt 控 件 都 有 其 对 应 的 Qt 控件 。 所 以 PyQt 与 Qt 
的 类 库 和 API 非 常 详细 ， 而 且 PyQt 不 再 使 用 qmake 系 统 和 Q_OBJECT 
宏 ， 使 得 PyQt 再 也 没有 编译 链接 错误 ，PyQt 的 代码 也 更 加 友好 。 

其 次 ， 在 开发 速度 上 ， 由 于 PyQt 的 核心 就 是 Qt 库 ， 也 是 用 C++ 编 写 
的 ， 所 以 即使 逻辑 代码 运行 速度 慢 一 点 ， 也 不 会 成 为 性 能 瓶 诺 。 在 使 用 
方式 上 ，PyQt 也 没有 失去 Python 的 优雅 语法 、 快 速 开 发 的 能 力 。Python 
相对 于 C++ 的 优点 是 在 编程 效率 上 ， 可 以 看 到 标准 的 Qt 例子 移植 到 PyQt 
后 的 代码 具有 相同 的 功能 ， 使 用 相同 的 应 用 程序 接口 ，Python 版 本 的 代 
码 只 有 原来 的 50% 一 60%， 而 且 更 容易 阅读 。 在 开发 效率 上 ， 由 于 
Python 是 一 种 面向 对 象 的 语言 ， 语 法 简单 、 高 效 ， 相 对 于 C++ 而 言 ， 使 
用 Python 编写 程序 可 以 提高 开发 效率 ， 减 少 开发 成 本 。 

最 后 ，PyQt 向 Python 程序 员 提 供 了 使 用 完整 的 Qt 应 用 程序 接口 的 函 
数 ， 几 乎 可 以 用 Python 做 任何 Qt 能 做 的 事 。Qt 和 PyQt 的 设计 都 是 完全 面 
向 对 象 的 。Qt 使 用 一 种 称 为 信号 / 覃 的 机 制 在 窗口 控件 之 间 传 递 事 件 和 
消息 。 这 种 机 制 完全 不 同 于 其 他 图 形 界面 开发 库 所 采用 的 回调 
(callback) 机制， 使 用 信号 / 槽 可 以 使 程序 更 加 安全 和 简洁 。 所 开发 的 
应 用 程序 越 大 ，QtPyQt 的 这 个 优势 就 越 明显 。 














1.1.3 其 Z, TENTE 


从 Python 语言 的 诞生 之 日 起 ， 就 有 许多 优秀 的 GUI 工具 集 被 整合 到 
Python 当中 ， 使 得 Python 也 可 以 在 图 形 界面 编程 领域 大 展 喘 手 。 由 于 
Python 的 流行 ， 许 多 应 用 程序 都 是 用 Python 结合 这 些 优秀 的 GUI 工具 
集 编写 的 。 下 面 分 别 介绍 Python GUI 编程 的 各 种 实现 〈 内 容 来 自 维基 百 
科 ) 。 

1.Tkinter 

Tkinter 是 绑 定 了 Python 的 Tk ”GUI 工具 集 ， 就 是 Python 包装 的 Tcl 代 
人 码 ， 通 过 内 骸 在 Python 解 释 器 内 部 的 Ta 解释 器 实现 。 将 Tkinter 的 调用 转 
换 成 Tal 命令， 然后 交 给 Tcl 解 释 器 进行 解释 ， 实 现 Python 的 GUI。Tk 和 
其 他 语言 的 绑 定 ， 比 如 PerlTk， 是 直接 由 Tk 中 的 C 库 实现 的 。 

Tkinter 是 Python 事实 上 的 标准 GUI， 在 Python 中 使 用 Tk GUI 工具 集 
的 标准 接口 ， 已 经 包含 在 Python Windows 安 装 程序 中 ， 闭 名 的 IDLE 就 
是 使 用 Tkinter 实 现 GUI 的 。 

2.wxPython 

wxPython 是 Python 对 跨 平 台 的 GUI 工 具 集 wxWidgets (用 C++ 编 写 ) 
的 包装 ， 作 为 Python 的 一 个 扩展 模块 来 实现 。 

wxPython 是 比较 流行 的 Tkinter 的 一 个 蔡 代 品 ， 在 各 种 平台 上 都 表现 
Ruy. 

3.PyGTK 

PyGTK 是 Python 对 GTK+GUI 库 的 一 系列 包装 。 

PyGTK 是 比较 流行 的 Tkinter 的 一 个 蔡 代 品 ，Gnome 下 许多 著名 应 用 
程序 的 GUI 都 是 使 用 PyGTK 实 现 的 ， 比 如 BitTorrent、GIMP 等 。 

PyGTK 和 Gedit 都 有 可 选 的 实现 ， 在 Windows 平 台 上 似乎 表现 不 太 
好 ， 这 一 点 也 无 可 厚 非 ， 毕 竟 使 用 的 是 GTK 的 GUI 库 。 

4.PySide 

















PySide 由 Qt 官方 维护 ， 目 前 最 新 版 本 是 1.2.4， 完 成 了 对 Qt 4.8 版 本 
的 完整 实现 。PySide 是 Python 对 路 平台 的 GUI 工具 集 Qt 的 另 一 个 包装 ， 
捆绑 在 Python 当中 。 

PySide 是 比较 流行 的 Tkinter 的 一 个 奉 代 品 ， 拥 有 LGPL ”2.1 授权 许 
可 ， 人 允许 进行 免费 的 开源 软件 和 私有 的 商业 软件 的 开发 。 

在 上 面 的 图 形 界 面 开 发 库 中 ， 由 于 前 三 个 没有 类 似 于 Qt Designe (r 
UI 制作 工具 ， 它 可 以 通过 可 视 化 操作 创建 ”UI 文件 ， 然 后 通过 工具 快速 
编译 成 Python 文 件 ， 因 此 也 可 以 把 它 视 为 一 个 代码 生成 器 〉 的 工具 ， 所 
有 的 代码 都 需要 手动 输入 ， 学 习 曲 线 非常 陡峭 ;而 第 四 个 PySide 本 质 上 
也 是 Qt 的 Python 封装 ， 只 是 文 持 Qt 的 版 本 比较 老 ， 最 新 版 本 才 文 持 到 
Qt 4.8， 而 且 官 方 已 经 停止 维护 这 个 库 ， 最 近 一 次 更 新 是 在 2015 年 10 月 
14 日 。 所 以 ， 对 于 Python 使 用 者 来 说 ， 使 用 PyQt 进 行 GUI 开 发 是 最 好 的 
选择 ， 这 也 是 本 书 选择 PyQt 的 原因 。 








1.1.4 PyQt 4/PyQt5 





PyQt 5 不 再 向 下 兼容 使 用 PyQt 4 编写 的 程序 ， 因 为 PyQt 5 有 如 下 几 
PEA 

(1) PyQt 5 不 再 对 Python 2.6 以 前 的 版 本 提供 文 持 ， 它 对 Python 3 
的 支持 比较 完善 ， 官 方 默认 只 提供 Python 3 版 本 的 安装 包 ， 如 果 需 要 使 
用 Python 2.7， 则 需要 上 自行 编译 PyQt 5 程序 。 

(2) PytQt5 对 一 些 模块 进行 了 重新 构建 ， 一 些 旧 的 模块 已 经 被 铭 
弃 ， 比 如 PyQt 4 的 QtDeclarative、QtScript 和 QtScriptTools 模 块 ， 一 些 模 
块 被 拆 分 到 不 同 的 模块 中 ， 比 如 PyQt 4 的 QtWebKit 模 块 被 拆 分 到 PyQt 5 
的 QtWebKit 和 QtWebKitWidgets 模 块 中 。 

(3) PyQt 5 对 网 页 的 支持 更 是 与 时 俱 进 。PyQt 4 的 QtWebKit 模 块 
是 Qt 团队 基于 开源 的 WebKit 引 擎 开发 维护 的 ， 由 于 它 使 用 的 WebKit 引 








擎 版 本 比较 老 ， 对 互联 网 的 新 生 事 物 尤其 是 对 JavaScript 的 支持 不 是 很 
完美 ，PyQt 5 所 使 用 的 QtWebKitWidgets 模 块 (PyQt 5.7 以 上 版 本 ) 是 谷 
歌 团 队 开发 的 chromium 内 核 引 擎 ， 由 于 更 新 维护 速度 很 快 ， 基 本 上 完美 
支持 互联 网 的 新 生 事物 。 

(4) PyQt 5 仅 文 持 新 式 的 信号 和 槽 ， 对 旧式 的 信号 和 槽 的 调动 将 
不 再 支持 ， 新 式 的 信号 和 覃 使 用 起 来 更 简单 。 

(5) PyQt 5 不 支持 在 Qt 5.0 中 标记 为 已 放弃 或 过 时 的 Qt API 部 分 。 

(6) PyQt 5 在 程序 需要 时 才 释 放 GIL， 而 PyQt 4 是 执行 完 程 序 后 强 
制 释 放 GIL。 

由 于 官方 对 PyQt 4 不 再 有 重大 的 更 新 和 维护 ， 对 于 新 手 来 说 ， 建 议 
直接 从 PyQt 5 入 手 。 


1.1.5 Python 2/Python 3 


Python 2 与 Python 3 虽然 语法 结构 有 些 类 似 ， 但 是 却 不 能 完全 鳞 容 。 
本 书 主要 介绍 的 是 PyQt 5， 上 所 使 用 的 语言 开发 环境 是 Python 3， 原 因 如 
Tee 

(1) HAJ, Python 2 的 绝 大 部 分 框架 都 提供 了 对 Python 3 的 支持 ， 
并 且 一 些 新 框架 如 TensorFlow 等 只 提供 了 对 Python 3 的 支持 。 

(2) 对 于 Python 2 官方 只 支持 到 2020 年 ， 而 PyQt 5 是 一 个 新 框架 ， 
新 框架 往往 不 会 对 即将 被 淘汰 的 语言 提供 太 多 的 支持 。 

(3) Python 3 默认 使 用 UTF-8 编 码 ， 对 中 文字 符 串 无 颖 兼容 。 

(4) 使 用 Python 3 开发 PyQt 5， 不 用 考虑 中 文 编码 的 问题 ， 不 需要 
使 用 类 似 于 QstringO 这 样 的 函数 转换 含有 中 文 的 字符 串 ， 可 以 节省 大 量 
的 时 间 和 精力 ， 代 码 看 起 来 也 更 加 舒服 。 

(5) PyQt 5 官方 默认 只 提供 对 Python ”3 的 支持 ， 如 果 必 须 使 用 
Python 2， 则 需要 自行 编译 ， 特 别 抵 烦 。 














最 后 两 点 是 重要 原因 ， 使 用 Python 3 是 最 好 的 选择 ， 所 以 本 书 使 用 
的 是 Python 3 的 语言 开发 环境 。 


1.2 PyQt 5 环境 搭建 


本 节 讲 解 如 何在 最 常见 的 PC 操作 系统 平台 上 配置 PyQt 5 开发 环境 ， 
包括 搭建 Python 3 解释 器 环境 和 编程 库 等 。 

对 于 新 手 来 说 ， 独 立 配置 PyQt 5 的 安装 环境 是 比较 困难 的 ， 为 了 减 
轻 读者 的 负担 ， 笔 者 为 本 书 封装 了 可 以 运行 书 中 所 有 程序 的 绿色 版 的 
PyQt ”5 环境 ， 解 压缩 后 即 可 使 用 ， 不 会 影响 系统 的 默认 环境 ， 适 合 对 
Python 刚 入 门 的 新 手 或 不 想 为 本 书 重新 安装 一 个 环境 的 老手 。 详 细 情 况 
和 下 载 地 址 见 笔 者 的 github 主 页 Chttps://github.com/cxinping/PyQt5) 。 











本 节 讲 解 在 Windows 下 安装 并 配置 PyQt 5 开发 环境 。 
安装 环境 信息 如 表 1-1 所 示 。 


操作 系统 Windows 8 64 位 平台 


安装 软件 如 图 1-4 所 示 。 
由 于 Python 是 解释 性 编程 语言 ， 所 以 需要 解释 器 将 源码 翻译 成 机 器 











语言 。 运 行 Python 需 要 事先 配置 好 Python 环境 。 





J eric6-17.04.1.zip 
J eric6-i18n-zh_CN-17.04.1.zip 
[P python-3.5.3-amd64.exe 


图 1-4 








目前 Python 在 生产 环境 中 用 得 比较 多 的 版 本 是 Python “2.7 和 Python 
3.5， 这 通常 会 给 Python 的 初学 者 造成 一 些 困 扰 ， 不 知道 该 学 习 老 版 本 
Python 2 还 是 最 新 版 本 Python 3。 根 据 笔者 的 经 验 ， 完 全 不 必 有 这 种 困 
扰 ， 只 要 学 会 Python 3， 再 花 一 点 时 间 学 习 Python 2 的 语法 ， 那 么 Python 
2 和 Python 3 就 都 学 会 了 。Python 2 和 Python 3 只 有 少量 的 语法 差异 ， 而 
在 软件 开发 中 最 重要 的 是 编程 思想 。 

需要 注意 的 是 ，Python 3 不 同 后 兼容 ， 因 为 从 Python 2 到 Python 3 发 
生 了 语法 的 变化 。 虽 然 最 新 版 本 Python 3 发 布 了 很 信 ， 但 仍然 有 很 多 软 
件 包 没有 升级 到 最 新 版 本 ， 所 以 使 用 第 三 方 Python 库 时 要 注意 区 分 不 同 
的 版 本 ， 避 人 免 出 现 不 兼容 问题 。 

1. 安 装 Python 3 运行 环境 

访问 Python 官 方 网 站 : https://www.python.org。 

因为 要 使 用 的 是 最 新 版 本 PyQt 5.9， 它 要 求 使 用 Python 3， 所 以 
Python 的 版 本 应 该 在 3.5 及 以 上 ， 这 里 使 用 Python 3.5.3。 在 下 载 页 面 
(https://www.python.org/downloads/windows/〉 中 下 载 PyQt 5 库 所 需要 的 
Python ”3.5.3 版 本 ， 读 者 可 根据 自己 使 用 的 平台 选择 相应 的 版 本 进行 下 
载 。 对 于 Windows 用 户 来 说 ， 如 果 是 32 位 系统 ， 则 选择 x86 版 本 ; WR 
是 64 位 系统 ， 则 选择 x86-64 版 本 。 下 载 完 成 后 ， 会 得 到 一 个 以 .exe 为 扩 
展 名 的 文件 ， 双 击 该 文件 进行 安装 ， 如 图 1-5 所 示 。 

















@ Python Releases for W x 
€ Cis Python Software Foundation [US] | https://ww.python.org/downloads/windows/ 


a Python 3.5.3 - 2017-01-17 
Download Windows x86 web-based installer 
Download Windows x86 executable installer 
Download Windows x86 embeddable zip file 
Download Windows x86-64 web-based installer 
Download Windows x86-64 executable installer 


Download Windows x86-64 embeddable zip file 





Download Windows help file 


图 1-5 


选择 自 定 义 安装 Python ”3.5.3， 如 图 1-6 所 示 。 安 装 路 径 可 以 自己 决 
定 ， 笔 者 的 安装 路 径 是 Ei\installed_software\python35， 如 图 1-7 所 示 。 

注意 

在 安装 过 程 中 按照 提示 一 步 步 操 作 就 行 ， 但 安装 路 径 尽 量 不 要 市 有 
中 文 或 空格 ， 以 避免 在 使 用 过 程 中 出 现 一 些 英 名 的 错误 。 





Install Python 3.5.3 (64-bit) 


Select Install Now to install Python with default settings, or choose 
Customize to enable or disable features. 


® Install Now 
C:\Users\si\AppData\Local\Programs\Python\Python35 


Includes IDLE, pip and documentation 
Creates shortcuts and file associations 


ə Customize installation 


Choose location and features 


python 
for [Vi Install launcher for all users (recommended) 


windows C Add Python 3.5 to PATH 





图 1-6 


Advanced Options 

口 Install for all users 

Associate files with Python (requires the py launcher) 
Create shortcuts for installed applications 

口 Add Python to environment variables 

口 Precompile standard library 

口 Download debugging symbols 

口 Download debug binaries (requires VS 2015 or later) 


Customize install location 


| E:\installed_software\python35 | 





python 


windows 








图 1-7 


安装 完成 后 ， 可 以 在 “开始 ”菜单 中 看 到 Python 3.5 目 录 ， 如 图 1-8 所 


> 


所 有 应 用 程序 > PYTHON 3.5 


@ IDLE (Python 3.5 64-bit) 


控制 面板 
BP python 3.5 (64-bit) 


R sili E? Python 3.5 Manuals (64-bit) 


@ Python 3.5 Module Docs (64-bit) 
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打开 Python 自 带 的 IDLE(Python 3.5 64-biD， 就 可 以 编写 Python 程序 
J. Python Shell 界 面 如 图 1-9 所 示 。 


File Edit Shell Debug Options Window Help 
Python 3.5.3 (v3.5.3: 1880cb95a742, Jan 16 2017, 16:02:32) [MSC v.1900 64 bit (AM 


D64)] on win32 
Sal “copyright”, “credits” or “license()” for more information. 
>>> 





图 1-9 


还 需要 把 Python 的 安装 目录 添加 到 系统 环境 变量 Path 中 ， 在 桌面 上 


右 击 “我 的 电脑 *"， 弹 出 快捷 菜单 ， 选 择 “ 属 性 ” “高 级 系统 设置 ?> “高 
级 ”， 单 击 “ 环 境 变 量 ” 按 钮 ， 如 图 1-10 所 示 。 


E:\installed_software\ssh 
%USERPROFILE%\AppData\Local\Temp 
%USERPROFILE%\AppData\Local\Temp 


系统 变量 (S) 
TE a 
M2_HOME E:\installed_software\apache-maven-3.2.5 
NUMBER_OF_PRO... 4 
Windows_NT 
%M2_HOME%\bin;.;%JAVA_HOME%/bin«... 
_PATHEXT .COM;.EXE;.BAT;.CMD;.VBS;. VBE; JS; JSE;.W... Y 








图 1-10 


在 系统 变量 Path 中 添加 变量 值 : 
E:/installed_software/python35;E:/installed_software/python35/Script: 
注意 


E:/installed_software/Python35 是 笔者 在 本 机 上 安装 Python 3.5.3 的 位 





置 ， 读 者 需要 根据 自己 机 器 上 的 实际 情况 进行 修改 。 
添加 变量 值 成 功 后 ， 如 图 1-11 所 示 。 





E:\installed_software\ssh 
%USERPROFILE%\AppData\Local\Temp 
%USERPROFILE%\AppData\Local\Temp 





M2_HOME E:\installed_software\apache-maven-3.2.5 
NUMBER_OF_PRO... 4 
Windows_NT 
:E:/installed_software/python35;E-/installe... 
.COM;.EXE:.BAT;.CMD;.VBS;. VBE: JS; JSE;.W... Y 











图 1-11 


现在 ， 我 们 检验 一 下 Python 是 否 安装 成 功 。 按 “Win+R” 快 捷 键 运行 
cmd 命 令 ， 进 入 DOS 横 式 ， 如 图 1-12 所 示 。 


Windows 将 根据 你 所 输入 的 名 称 ， 为 你 打开 相应 的 程序 、 文 
件 夹 、 文 档 或 Internet 资源 。 


TJ) 


打开 (0) GE 














图 1-12 


在 命令 行 输入 python， 开 始 启动 Python IDLE (Python 交互 环境 ) ， 
需要 几 秒 钟 的 时 间 。 局 动 后 ， 读 者 就 可 以 看 到 它 的 界面 中 包含 了 一 个 交 
互 式 终端 ， 也 可 以 看 到 所 安装 的 Python 版 本 号 ， 如 图 1-13 所 示 。 这 时 


Python 的 运行 环境 束 安 闭 好 了 。 


Microsoft Windows [版 本 6.3.9600] 
(c) 2013 Microsoft Corporation 


C:\Users\si>Python 

Python 3.5.3 (v3.5.3:1880cb95a742, Jan 16 2017, 16:02:32) [MSC v.1900 64 bit (AM 
D64)] on win32 

Type “help”, “copyright”, “credits” or “license” for more information. 





图 1-13 





它 的 行 首 显示 的 3 个 大 于 号 (>>>) 是 命令 提示 符 ， 当 你 看 到 这 
个 提示 符 时 ， 束 表示 解释 器 正在 等 待 输入 命令 。 下 面 尝 试 在 命令 提示 符 
后 输入 : 
print("hello python") 


按 回 车 键 ，Python 束 会 执行 所 输入 的 命令 ， 并 在 窗口 中 显示 运行 结 
果 ， 如 图 1-14 所 示 。 

也 可 以 把 命令 行 看 成 计算 器 来 计算 表达 式 的 值 。 把 在 命令 提示 符 后 
面 输入 的 每 一 条 命令 看 成 一 个 程序 ， 命 令 行 每 次 只 运行 这 个 程序 中 的 一 
行 ， 如 图 1-15 所 示 。 


还 可 以 在 命令 行 中 创建 变量 或 导入 模块 ， 如 图 1-16 所 示 。 











>>> print(“hello python”) 





图 1-14 


>>> 2+3 
= 
>>> 





图 1-15 


>>> import math 
>>> r = math.sqrt(9) 
>>> print(r) 





图 1-16 


import 命 令 把 Python 数学 函数 库 的 功能 都 导入 到 程序 中 供 你 使 用 。 
上 面 的 程序 使 用 了 变量 和 赋值 运算 符 0=) ， 其 含义 是 对 9 开平 方 根 ， 并 
把 结果 赋值 给 r， 了 最 后 把 结果 打印 到 屏 医 上 。 

可 以 通过 help 命 令 获 取 茶 个 函数 ， 以 及 模 其 的 Python 功能 描述 ， 如 








图 1-17 所 示 。 
help("print") 
>>> help("print”) 
Help on built-in function print in module builtins: 


print(...) 
print(value, ..., sep=" *, end="\n', file=sys.stdout, flush=False) 


Prints the values to a stream, or to sys.stdout by default. 

Optional keyword arguments: 

file: a file-like object (stream); defaults to the current sys.stdout. 
sep: string inserted between values, default a space. 

end : string appended after the last value, default a newline. 

flush: whether to forcibly flush the stream. 





图 1-17 


如 果 想 退出 命令 行 模式 ， 请 按 “Ctrl+C” 快 捷 键 或 输入 exit()。 

2. 安 装 PyQt5 

PyQt 5 的 官方 网 站 是 : https://www.riverbankcomputing.com/. #2 
本 书 成 书 之 时 ，PyQt 5 的 最 新 版 本 是 5.9。 安 装 PyQt 5 有 两 种 方式 : 既 可 
以 下 载 PyQt 5 的 最 新 源码 进行 编译 安装 ， 也 可 以 使 用 pip install 进行 在 
线 安装 。 对 于 初学 者 来 说 ， 通 过 编译 PyQt 5 源码 的 方式 进行 安装 和 配置 
环境 比较 麻烦 ， 笔 者 推荐 使 用 pip install 命令 在 线 安装 PyQt 5， 这 种 “一 
键 式 ”的 安装 方式 是 最 简单 的 ， 只 需要 运行 一 行 命令 即 可 。 但 需要 注意 
的 是 ，Python 安 装 模 块 使 用 的 镜像 默认 是 国外 的 ， 因 为 网 络 问题 ， 在 国 
内 下 载 国外 的 Python 模块 会 比较 慢 ， 还 经 常会 下 载 失败 ， 所 以 需要 使 用 
内 的 镜像 下 载 Python 模块 。 比 如 在 下 面 命令 中 加 上 参数 “-i 
https:/pypi.douban.com/simple”， 束 表示 使 用 豆 办 提供 的 镜像 服务 。 

pip install PyQt5-i https://pypi.douban.com/simple 
安 闭 成功 后 ， 如 图 1-18 所 示 。 























148kB/s 
172kB/s 
173kB/s 
173kB/s 
173kB/s 
173kB/s 


3 173kKB/s 


7 . 2MB 


7 E 
100% | tt ti 
Requirement already satisfied: 
(from PyQtS) 
Installing collected packages: PyQtS 
Successfully installed PyQt5-5.9 


图 1-18 


PyQt 5.9 不 再 提供 常用 的 Qt 工具 ， 比 如 图 形 界面 开发 工具 Qt 
Designer、 国 际 化 翻译 工具 Liguist， 所 以 还 需要 使 用 如 下 命 


的 Qt 工具 。 


.2MB 
‘a 77.2MB 213kB/s 
e\python35\lib\site-package 


174kKB/s 
173kB/s 
173kB/s 
192kB/s 
212kB/s 
162kB/s 
163kB/s 
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pip install PyQt5-tools-i https://pypi.douban.com/simple 


安装 成 功 后 ， 如 图 1-19 所 示 。 


36. 
36. 
36. 
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图 1-19 


OMB 
OMB 
OMB 
1MB 
1MB 
1MB 
1MB 
1MB 
1MB 
1MB 
1MB 
1MB 
1MB 


使 用 pip install 命令 安装 PyQt 5, PyQt5-tools 
在 %\python35\Lib\site-packages 目录 下 看 到 安装 包 PyQt5、pyqt5-tools。 


193kB/s 
17?kB/s 
174kB/s 
174kB/s 
173kB/s 
175kB/s 
174kB/s 
234kKB/s 
175kB/s 
175kB/s 
148kB/s 
159kB/s 
207kB/s 


成 功 后 ， 
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笔者 的 安装 目录 是 E:\installed_software\python35\Lib\site-packages， 如 图 
1-20 所 示 o 




















© ~ 个 | > RERBA > 新 加 卷 (E:) > installed_software > python35 > Lib > site-packages 

— 名 称 修改 日 其 类 型 
E pyasni EU IJOJA 1:51 LHA 
n PR l. pyasn1_ modules 2017/8/1 15:37 文件 夫 
Bea |. pyasn1_modules-0.0.10.dist-info 2017/8/1 15:37 xip 
D Ree l. pyasn1-0.3.1.dist-info 2017/8/1 15:37 MASE 
; i. pycparser 2017/8/1 15:37 文件 夫 
ete |. pycparser-2.18-py3.5.egg-info 2017/8/1 15:37 文件 夫 
I. pydispatch 2017/8/1 15:37 witk 
RES l. PyDispatcher-2.0.5-py3.5.egg-info 2017/8/1 15:37 v4 
|. PyInstaller 2017/3/28 0:27 文件 夫 
W 这 台电 及 l. Pylnstaller-3.2.1-py3.5.egg-info 2017/3/28 0:28 文件 夹 
a l. PyOpenGL-3.1.0-py3.5.egg-info 2017/5/10 19:11 witk 
> s l. pyOpenSSL-17.2.0.dist-info 2017/8/1 15:37 文件 夫 
pyparsing-2.2.0.dist-info 2017/5/9 10:33 文件 夫 
n ane l. pypiwin32_system32 2017/3/28 0:27 文件 夹 
sent j iwin32-219.dist-info 2017/3/28 0:27 文件 到 
— J PyQts 2017/8/2 14:11 文件 夫 
ee a pyqt5_tools-5.8.2.1.0.dist-info 2017/8/2 14:23 文件 夹 
> OnE (D) l. PyQt5-5.9.dist-info 2017/8/2 14:12 wit 
v ine E) | i. pyqt5-tools | 2017/8/2 14:23 SHEE 
|. python_dateutil-2.6.0.dist-info 2017/5/9 10:33 文件 夫 
篇 aa I. pythonwin 2017/3/28 0:27 文件 夹 
J. pytz 2017/5/9 10:33 SUSE 
i. pytz-2017.2.dist-info 2017/5/9 10:33 文件 夫 

图 1-20 


为 了 让 Windows 系统 能 够 正确 识别 PyQt5-tools Wii Hire, Wii 
要 把 PyQt5-tools 的 安装 目录 添加 到 系统 环境 变量 Path 中 。 在 蝎 面 上 右键 
单 击 “我 的 电脑 ”， 弹 出 快捷 荣 单 ， 选 择 “ 属 性 ” “局 级 系统 设置 ”" “高 
级 ”， 单 击 “ 环 境 变 量 ” 按 钮 ， 在 系统 变量 Path 中 谎 加 以 下 变量 值 ， 如 图 1- 
21 所 示 。 
E:/installed_software/python35/Lib/site-packages/pyqt5-tools; 








注意 

E:/installed_software/python35/Lib/site-packages/pyqt5-tools 是 笔者 在 
本 机 上 安装 PyQt5-tools 的 位 置 ， 读 者 需要 根据 自己 机 器 上 的 实际 情况 进 
行 修改 。 








| Path 








5/Lib/site-packages/pyqt5-tools;E:\installed_ 














变量 

M2_HOME E:\installed_software\apache-maven-3.2.5 

NUMBER_OF_PRO... 4 

OS Windows_NT 

Path E:\installed_software\python35\Lib\site-p... 
.COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.W... Y 








FW)... | SED. EBL) 


Fl 








图 1-21 


然后 ， 在 Windows 的 命令 行 窗 口中 输入 path 命 令 ， 如 果 一 切 正 常 ， 
则 会 在 所 返回 的 Path 路 径 中 看 到 刚才 配置 的 python35 和 PyQt5-tools 的 安 
装 路 径 ， 如 图 1-22 所 示 。 


C:\Users\si\Desktop>path 

PATH= ;E:/installed_software/python35/Lib/site-packages/pyqt5-tools;E:\installed_software\python35\Li 
b\site-packages\PyQt5; . {/E:/installed_software/pythonss ;E: /installed_software/python35/Scripts;E:\in 

talled_software\apache-maven-3.2.5\bin; .;E:\installed_software\JDK1_7_1204/bin;C:\Program Files (x86 
)\Intel\iCLS Client\;C:\Program Files\Intel\iCLS Client\;C:\windows\system32;C:\windows ;C:\windows\S 
ystem32\Wbem;C:\windows\System32\WindowsPowerShell\v1.0\;C:\Program Files\Intel\Intel(R) Management 


Engine Components\DAL;C:\Program Files (x86)\Intel\Intel(R) Management Engine Components\DAL;C:\Prog 
ram Files\Intel\Intel(R) Management Engine Components\IPT;C:\Program Files (x86)\Intel\Intel(R) Mana 
gement Engine Components\IPT;C:\Program Files (x86)\ATI Technologies\ATI.ACE\Core-Static;C:\Program 
Files\Intel\WiFi\bin\;C:\Program Files\Common Files\Intel\WirelessCommon\;C:\Program Files (x86)\Com 
mon Files\lenovo\easyplussdk\bin;C:\ProgramData\Lenovo\ReadyApps;C: /Users/si/AppData/Roaming/npn; 





图 1-22 


最 后 ， 测 试 PyQt 5 环境 是 否 安装 成 功 ， 文 件 名 为 
PyQt5/Chapter01/qt101_testPyQt.py，.py 是 Python 文件 的 扩展 名 。 其 完整 
代码 如 下 : 

import sys 

from PyQt5 import QtWidgets,QtCore 
app=QtWidgets.QApplication(sys.argv) 
widget=QtWidgets.QWidget() 
widget.resize(360,360) 
widget.setWindowTitle("hello,pyqt5") 
widget.show() 

sys.exit(app.exec_()) 

在 Windows 系 统 中 ， 双 击 qtL01_testPyQt.py 文 件 ， 或 者 在 Windows 命 
令 行 窗口 中 运行 如 下 命令 : 

python qt101_testPyQt.py 
如 果 没 有 报错 ， 弹 出 如 图 1-23 所 示 的 窗口 CWidget) 界面 ， 则 说 明 





PyQt 5 环境 安装 成 功 。 


图 1-23 


1.2.2 在 Mac OS 下 搭建 PyQt 5 环境 


本 节 讲 解 在 Mac OS 下 安装 并 配置 所 需 的 PyQt 5 开发 环境 ， 包 括 基于 
Python3.5 开 发 环境 的 搭建 。 在 Mac OS 下 安装 PyQt 5 环境 需要 使 用 Linux 
命令 ， 比 在 Windows 下 安装 麻烦 些 ， 但 只 要 熟悉 安装 命令 还 是 很 简单 
的 。 

在 Mac OS 平台 下 需要 通过 源码 来 安装 PyQt 5。 在 构建 (build) 前 ， 
必须 安装 SIP。 

安装 环境 信息 如 表 1-2 所 示 。 








Python 3.5.3 


SIP 














截至 本 书 成 书 之 时 ， 在 Mac OS 下 最 稳定 的 版 本 是 PyQt 5.9。 安 装 开 
发 环境 所 需要 的 软件 如 图 1-24 所 示 。 














名 称 a ”修改 日 期 大 小 种 类 
P pyQt5_gpl-5.9.tar.gz 今天 下 午 4:26 3.1MB “gzip 压缩 归档 
© python-3.5.3-macosx10.6.pkg 2017 年 1 月 25 日 上 午 11:48 24.8 MB 安装 器 软件 包 
& qt-opensource-mac-x64-5.9.1.dmg 今天 下 午 5:18 3.74 GB BR Re 
P sip-4.19.3.tar.gz 今天 下 午 4:47 1MB gzip 压缩 归档 
图 1-24 
1. 安 装 Qt 5.9.1 


双击 app 开 始 安装 Qt 5.9.1， 如 图 1-25 所 示 。 安 装 路 径 可 以 自 定义 ， 
笔者 的 安装 路 径 是 /Users/xinping/Qt5.9.1， 如 图 1-26 所 示 。xinping 是 笔者 
登录 Mac OS 系统 的 用 户 名 ， 读 者 需要 根据 实际 情况 进行 修改 。 








Oae@ qt-opensource-mac-x64-5.9.1 


qt-opensource-mac- 
x64-5.9.1.app 











图 1-25 


Qt 5.9.1 设置 





安装 文件 夹 





Please specify the directory where Qt 5.9.1 will be installed. 


/Users/xinping/Qt5.9.1 浏览 ..… 





图 1-26 


接 下 来 ， 按 照 默 认 设 置 进 行 操作 即 可 ， 如 1-27 所 示 。 


Qt 5.9.1 it 


选择 组 件 





请 选择 您 想 要 安装 的 组 件 。 


Qt 5.9.1 


v 目 Qt 5.9:1 此 组 件 将 占用 您 大 约 

macOS 3.55 GB 的 硬盘 空间 。 

|] ios 
| Android x86 

Android ARMv7 
Sources 
Qt Charts 
Qt Data Visualiza... 
Qt Purchasing 
Qt Virtual Keyboa... 
Qt WebEngine 
Qt Network Auth ... 
Qt Remote Objec... 
Qt Speech (TP) 
Qt Script (Deprec... 
v & Tools 

Qt Creator 4.3.1 


四 加 四 四 四 四 四 四 上 














图 1-27 


单 击 “继续 ”按钮 ， 按 照 提 示 安 装 Qt 5.9.1， 如 果 出 现 如 图 1-28 所 示 的 
画面 ， 则 说 明 Qt 5.9.1 安 装 成 功 。 


Qt 5.9.1 ii 
正在 完成 Qt 5.9.1 向 导 


Click 完成 to exit the Qt 5.9.1 Wizard. 


Launch Qt Creator 








图 1-28 


默认 选中 “Launch Qt Creator" 复 选 框 ， 单 击 “ 完 成 ?按钮 ， 就 会 打开 
Qt 自 带 的 开发 工具 Qt ”Creator， 通 过 该 工具 能 够 利用 Qt 这 个 应 用 程序 框 
架 更 加 快速 地 完成 开发 任务 ， 如 图 1-29 所 示 。 





Ú OtCrestor x Gi 6 Wik Anayze IA AF MD Ø Ssiso2 à = 
mum m 
e'e (Qt Crestor 


G& Open Project 


Recem Projects 


New to QU 


Get Started Now 


Resuts 3 GO 4 BI 6 Debugger Consele 8 TestResdts = 


LSO S6@8° ©. 


图 1-29 





2. 安 装 Python 3.5.3 

进入 下 载 页 面 https://www.python.org/downloads/mac-osx/， 选 择 
Mac 版 本 的 Python 3.5.3， 下 载 安 装 文件 python-3.5.3-macosx10.6.pkg。 
双击 pkg 文件 开始 安装 Python 3.5.3， 如 图 1-30 所 示 。 





8 = m a a olla 


个 人 收藏 
B 我 的 所 有 .… 
& iCloud Ori... 
A 应 用 程序 
B aw 
B 文稿 
O Të 


设备 





名 称 

F pyQt5_gpl-5.94ar.gz gzif 

LJ qt-ope… = æ python-3.5.3-macosx10.6.pkg 2017361258 11:48 24.8 MB 2È 
& qt-opensource-mac-x64-5.9.1.dmg 昨天 F518 3.74 GB 磁盘 

F sip-4,19.3.tar.gz 省 天 下 午 4;47 1 MB gzip 压缩 归档 


(J xinping 


Be 4:2¢ 


标记 


Mb ok 
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安装 过 程 如 图 1-31、 图 1-32、 图 1-33 所 示 。 


© 安装 "Python” 
欢迎 使 用 "Python "安装 器 
This package will install Python 3.5.3 for Mac OS X 10.6 or later. 
Python for Mac OS X consists of the Python programming language 


interpreter, plus a set of programs to allow easy access to it for Mac OS X 
users including an integrated development environment IDLE. 





IMPORTANT: IDLE and other programs using the tkinter graphical user 

interface toolkit require specific versions of the Tcl/Tk platiorm 

independent windowing toolkit. Visit https/www.python.org/download/ 

mac/tcitk/ for current information on supported and recommended 
(a "mr" versions of Tcl/Tk for this version of Python and Mac OS X. 
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恒安 装 Python 


标准 安装 将 执行 于 "xinping" 上 
这 将 占用 您 的 电脑 上 的 97.2 MB 空间 。 
点 按 “ 安 装 "以 在 磁盘 “xinping" 上 执行 此 软件 的 标准 安装 。 
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ec @ 安装 "Python” Pa 
安装 成 功 。 





安装 成 功 。 


软件 已 安装 。 











图 1-33 


3. 安 装 SIP 4.19.3 
进入 下 载 页 面 
https:/www.riverbankcomputing.com/software/sip/download， 下 载 安 装 文 
件 sip-4.19.3.tar.gz。 编 译 并 安装 步骤 如 下 : 
tar xvf sip-4.19.3.tar.gz 


cd sip-4.19.3 

python3.5 configure.py-d 
/Library/Frameworks/Python.framework/Versions/3.5/lib/python3.5/site- 
packages 

make 


make install 


4. 安 装 PyQt 5.9 
进入 下 载 页 面 
https://riverbankcomputing.com/software/pyqt/download5， 下 载 安 装 文件 
PyQt-gpl-5.9.tar.gz。 编 译 并 安装 步骤 如 下 : 
tar xvf PyQt-gpl-5.9.tar.gz 
cd PyQt-gpl-5.9 
python3.5 configure.py--qmake 
/Users/xinping/Qt5.9.1/5.9.1/clang_64/ 
bin/qmake —disable-QtPositioning-d 
/Library/Frameworks/Python.framework/Versions/3.5/lib/python3.5/si 
pac 
kages 
make 
sudo make install 
--dmake 选 项 用 于 指定 dmake 的 路 径 ， 路 径 中 的 用 户 名 是 “xinping”， 
读者 需要 根据 实际 情况 进行 修改 。 另 外 ， 在 编译 时 需要 加 上 编译 选项 
disable-QtPositioning， 人 否则 会 出 现 编译 错误 。 
5. 测 试 开发 环境 
在 Terminal (Aim) 输入 如 图 1-34 所 示 的 代码 ， 如 果 没 有 报错 ， 则 
说 明 安 装 成 功 。 





@oe 合 xinping — Python — 80x24 


|xinpingdeMac:~ xinping$ python3 


Python 3.5.3 (v3.5.3:1880cb95a742, Jan 16 2017, 08:49:46) 
[GCC 4.2.1 (Apple Inc. build 5666) (dot 3)] on darwin 
Type “help”, "copyright" 
>>> import PyQt5S 

[>>> PyQtS.__path__ 


» “credits” or "license" for more information. 


['/Library/Frameworks/Python. framework/Versions/3.5/lib/python3.5/site-packages/ 
PyQt5'] 


>>> i 
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1.2.3 PyQt5 的 安装 测 ; 


在 Windows 系 统 下 ， 按 “Win+R” 快 捷 键 弹出 运行 窗口 ， 如 图 1-35 所 
， 输 入 cmd 命 令 ， 进 入 DOS 控 制 台 


， 然 后 输入 python 命 令 ， 进 入 
IE 境 ， 如 图 1-36 


5 Windows 将 根据 你 所 输入 的 名 称 ， 为 你 打开 相应 的 程序 、 文 
E, VR Interet 资源 。 





打开 (O): |cmd| 


—¥F 





| we || 





图 1-35 


E:\ins 


Pytho 
Type 


talled_software\python35>python 


n 3.5.3 (U3.5.3:1886cb95a742, Jan 16 2017, 16:02:32) [MSC v.1960 64 bit (AMDG4)] on win32 
‘help", “copyright”, “credits” or “license” for more information. 








图 1-36 


接 下 来 输入 以 下 脚本 ， 如 果 运 行 成 功 ， 则 说 明 PyQt 5 安装 成 功 。 
import PyQt5 

如 末 想 要 了 解 PyQt 5 所 依赖 的 模块 ， 则 可 以 通过 help 命 令 来 租 看 。 
help(PyQt5) 

PyQt SP He A BER On I 1-37 AIT AS o 





m C:\windows\system32\cmd.exe - python 


PACKAGE CONTENTS 
QAxContainer 


QtDesigner 
QtGui 

QtHelp 
QtLocation 
QtMultimedia 
QtMultimediallidgets 
QtNetwork 
QtOpenGL 
QtPositioning 
QtPrintSupport 
Qtaml 

QtQuick 
QtQuickWidgets 
QtSensors 
QtSerialPort 
QtSql 

QtSug 

QtTest 


QtWebChannel 
QtWebEngineCore 
QtWebEnginelWjidgets 
QtWebSockets 


QtWidgets 

QtWinExtras 

QtXml 

QtXmlPatterns 
_Q0penGLFunctions_2_9 
_Q0penGLFunctions_2_1 
_Q0penGLFunctions_4_1_Core 
uic (package) 


FILE 
e:\installed_software\python35\lib\site-packages\pyqtS\__init__.py 





图 1-37 





安装 好 Python ”3.5 后 ， 在 实际 的 开发 中 ， 还 需要 根据 业务 选择 安装 
其 他 Python 模块 。 在 python35\Scripts 目录 下 会 看 到 有 许多 使 用 工具 ， 其 
中 pip 和 easy_install 是 在 线 一 键 安 闭 模 块 的 工具 ， 两 者 的 作用 是 一 样 
的 ，pip 是 easy_install 的 升级 版 本 ， 如 图 1-38 所 示 。 























| 这 台电 脑 > 新 加 卷 (E:) » installed_software » python35 » Scripts 
名 称 修改 日 期 类 型 大 小 
a) f2py.py 2017/5/9 10:33 PY 文件 1 KB 
® ' futurize.exe 2017/3/28 0:27 应 用 程序 73 KB 
a) futurize-script.py 2017/3/28 0:27 PY 文件 1 KB 
“A jsonschema.exe 2017/5/16 23:36 ”应 用 程序 96 KB 
jupyter.exe 2017/5/16 23:36 ”应 用 程序 96 KB 
“A jupyter-migrate.exe 2017/5/16 23:36 ”应 用 程序 96 KB 
jupyter-troubleshoot.exe 2017/5/16 23:36 应 用 程序 96 KB 
“A jupyter-trust.exe 2017/5/16 23:36 家 用 程序 96 KB 
B ' pasteurize.exe 2017/3/28 0:27 应 用 程序 73 KB 
a] pasteurize-script.py 2017/3/28 0:27 PY 文件 1 KB 
2017/3/22 17:43 ”应 用 程序 96 KB 
A pip3.5.exe 2017/3/22 17:43 应 用 程序 96 KB 
“A. pip3.exe 2017/3/22 17:43 ”应 用 程序 96 KB 
| pyi-archive_viewer.exe 2017/3/28 0:28 应 用 程序 73 KB 
| a) pyi-archive_viewer-script.py 2017/3/28 0:28 PY 文件 1 KB 
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下 面 以 安装 matplotlib 模 块 为 例 来 进行 说 明 。 从 Python 官网 的 
matplotlib 介 绍 可 知 ， 安 装 这 个 模块 ， 需 要 安装 许多 其 他 的 依赖 模块 ， 如 
setuptools、numpy、python-dateuti]、pytz、pyparsing、cycler 等 ， 如 果 手 
动 一 个 个 去 下 载 这 些 模块 来 安装 ， 那 承 太 费力 了 ， 所 以 此 时 easy_install 
和 pip 工 具 就 非常 有 用 了 。 

使 用 以 下 命令 来 安装 matplotlib: 

pip install matplotlib 
如 果 一 切 顺 利 ，matplotlib 将 安装 成 功 ， 如 图 1-39 所 示 。 








E:\installed_software\python35\Scripts>pip install matplotlib 
Collecting matplotlib 
Seen Iie matplotlib-2.6.1-cp35-cp35m-win_amd64 whl (8 
ans SSCSSSceRee eRe : oe sic 


iseti pypars sat 4,922.1 »=1 6 a matplotlib) 


gasp ; 2.9-py2.pyu3s-none-any ie (56k 
1007. | ia im een TTL ttt) eee 

betlecting « $61x>=1.10 (from matplotlib) 

Downloading $six~-1.10.9-py2.py3-none-any.whl 
Collecting cycler>=0.10 (from matplotlib) 

Downloading cyucler-0.10.0-py2.py3-none-any. whl 
Collecting numpy>=1.7.1 (from matplotlib) 

Nan ss n_amd64 whl (7 
TLL LL titi ttt LLL. EEE 
E pytz (from matplotlib) 

wen on ytz-2017.2-pu2.pyu3-none-any.whl (484 

aa eela] PULTE LULL Eee 491kB 25kB/ 


pum python-dateutil (from matplotlib 


aaa uthon_dateuti u3-none-anu.whl (194KB ) 
Ti TT | 
Installing collected packages op parsing, six, cycler, numpy, pytz, python-dateutil, matplotlib 
Successfully installed cycler-8.10.9 matplotlib-2.0.1 numpy-1.12.1 pyparsing-2.2.9 python-dateutil-2 
6.0 pytz-26017.2 six-1.10.0 
E:\installed_software\python35\Scripts 





图 1-39 
从 图 1-39 可 以 看 到 ，matplotlib 所 依赖 的 各 模块 都 安装 好 了 。 


1.2.5 PyQt5 的 API> 


安装 好 PyQt ”5 后 ， 如 果 想 知道 widget 类 及 其 子 类 有 哪些 属性 和 函 
数 ， 应 该 如 何 查 看 呢 ? 
方法 一 : 通过 命令 查看 PyQt 5 类 或 对 象 的 所 有 属性 。 
这 里 先 介 绍 两 个 内 置 函数 : dir() 和 help()。 
dir() 用 来 查询 一 个 类 或 者 对 象 的 所 有 属性 。 在 Python 交 互 环境 下 输 
入 以 下 代码 : 
from PyQt5.QtWidgets import QWidget 
dir( QWidget ) 
ee ee E 
导入 ， 使 用 dir0 函 数 打 印 QWidget 对 象 的 属性 和 函数 。 结果 如 图 1- 
40 所 示 。 


C: \Users\si\Desktop>python 

Python 3.5.3 (v3.5.3:1880cb95a742, Jan 16 2017, 16:02:32) [MSC v.1900 64 bit (AMD64)] on win32 

Type “help”, “copyright”, “credits” or “license” for more information 

>>> from PyQtS.QtWidgets import QWidget 

dir( QWidget ) 
[‘DrawChildren’, ‘DrawWindowBackground’, ‘IgnoreMask’, ‘PaintDeviceMetric’, ‘“PdmDepth’, ‘PdmDevicePi 
xelRatio’, ‘PdmDevicePixelRatioScaled’, ‘PdmDpiX', ‘PdmDpiY', ‘PdmHeight’, ‘PdmHeightMM’, ‘PdmNumCol 
*PdmPhysicalDpiX', ‘PdmPhysicalDpiY’, ‘PdmWidth', ‘PdmWidthMM', ‘RenderFlag’', ‘RenderFlags’., 
f 人 *, *__format__ 2 By 
"__getattribute__', adot" ‘“__hash__ 
E 加 _, __setattr__ 

__subclasshook , ‘_weakref__', ‘acceptDrops', ‘accessibleDescription’, ‘accessibleName’ , 
onEuent " ‘actions’, ‘activateWindow', ‘addAction’, ‘addActions’, ‘adjustSize’, ‘autoFillBackground’ 
“packgroundRole’, ‘baseSize’, ‘blockSignals', ‘changeEvent’, ‘childAt’, ‘childEvent’, ‘children’, 
‘childrenRect’, ‘childrenRegion’, ‘clearFocus’', ‘clearMask’, ‘close’, ‘closeEvent', ‘colorCount’, ‘¢ 
lonnectNotify’, ‘contentsMargins’, ‘contentsRect’', ‘contextMenuEvent’, ‘contextMenuPolicy’, ‘create’ 
“createWindowContainer’, ‘cursor’, ‘customContextMenuRequested’, ‘customEvent’, ‘deleteLater’, ‘dep 

‘destroy’, ‘destroyed’, ‘devType’', ‘devicePixelRatio', ‘devicePixelRatioF', ‘devicePixelRatioF$ 
‘disconnect’, ‘disconnectNotify’, ‘dragEnterEvent’, ‘dragLeaveEvent’, ‘dragMoveEvent’, ‘dropE 
“dumpObjectInfo’, ‘dumpObjectTree’, ‘dynamicPropertyNames’, ‘effectivelJinId’, ‘ensurePolished 

‘enterEvent’, ‘event’, ‘eventFilter’, ‘find’, ‘findChild’, ‘findChildren’, ‘focusInEvent’, ‘focus 
NextChild’, ‘focusNextPrevChild’, ‘focusOutEvent', ‘focusPolicy’, ‘focusPreviousChild’, ‘focusProxy’ 

focusllidget*, ‘font’, ‘fontInfo', ‘fontMetrics’, ‘foregroundRole’, ‘frameGeometry’, ‘“frameSize’, 
‘geometry’, ‘getContentsMargins’, ‘grab’, ‘grabGesture’, ‘grabKeyboard’, ‘grabMouse’, ‘grabShortcut" 

‘graphicsEffect’, ‘graphicsProxyWidget’, ‘hasFocus’, ‘hasHeightForllidth’, ‘hasMouseTracking’, ‘hei 
ght’, ‘heightForWidth’, ‘heightMM', ‘hide’, ‘hideEvent’, ‘inherits’, ‘initPainter', ‘inputMethodEven 
t', ‘inputMethodHints’, ‘inputMethodQuery’. ‘insertAction’, ‘insertActions’, ‘installEventFilter’, ° 
isActivellindow’, ‘isAncestorOf’', ‘isEnabled’', ‘isEnabledTo'. ‘isFullScreen’, ‘isHidden’, ‘isLeftToRi 
ght’, ‘isMaximized’', ‘isMinimized’, ‘isModal’, “isRightToLeft’', ‘isSignalConnected’, ‘isUisible’, ‘i 
sUisibleTo', ‘iswWidgetType’, ‘isWindow', ‘isWlindowModified', ‘isllindowType’, ‘keyPressEvent’. ‘keyRe 
leaseEvent’', ‘keyboardGrabber’, ‘killTimer*, ‘layout’, ‘layoutDirection’, ‘leaveEvent’, ‘locale’, ‘1 
logicalDpiX', ‘logicalDpi¥’, ‘lower’, ‘mapFrom', ‘mapFromGlobal', ‘mapFromParent', ‘mapTo', ‘mapToGlo 
bal’, ‘mapToParent’, ‘mask’, ‘maximumHeight’, ‘maximumSize’, ‘maximumWlidth’, ‘metaObject', ‘metric’, 
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helpO 用 来 查看 类 的 说 明文 档 。 同 理 ， 如 果 要 查看 PyQt 5 类 的 说 明 
文档 ， 则 需要 在 Python 交 互 环境 下 输入 以 下 代码 : 
from PyQt5.QtWidgets import QWidget 
help( QWidget ) 
返回 结果 如 图 1-41 所 示 。 


C:\Users\si\Desktop>python 

Python 3.5.3 (v3.5.3: 1880cb95a742, 
Type “help”, “copyright”, “credits” 
>>> from PyQtS.QtWidgets import QWi 
>>> help( QWidget ) 

Help on class QWidget in module PyQt5.QtWidgets: 


class QWidget(PyQtS.QtCore.QObject, 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


QWidget(parent: QWidget = None, 


Method resolution order: 
QWidget 
PyQtS.atCore.Q0bject 
sip.wrapper 
PyQtS .QtGui.QPaintDevice 
sip.simplewrapper 
builtins.object 


Methods defined here: 


acceptDrops( ...) 
acceptDrops(self) -> bool 


accessibleDescription(...) 


Jan 16 2017, 16:02:32) [MSC v.1900 64 bit (AMDG4)] on win32 
or “license” for more information. 
dget 


PyQtS.QtGui.QPaintDevice) 
flags: Union[Qt.WindowFlags, Qt.WindowType] = Qt.WindowFlags()) 


accessibleDescription(self) -> 


accessibleName(...) 
accessibleName(self) -> str 





图 1-41 


虽然 可 以 通过 helpO 函 数 在 终端 查看 指定 PyQt 5 类 的 帮助 信息 ， 但 是 





在 输出 的 帮助 信息 比较 多 的 情况 下 ， 查 看 就 不 太 方便 了 ， 那 有 没有 一 种 
方法 可 以 把 帮助 信息 输出 到 指定 文件 中 呢 ? 

答案 是 肯定 的 ， 本 例文 件 名 为 PyQt5/Chapter01/qt102_PrintApi.py， 
将 PyQt 5 中 的 QWidget 类 的 使 用 手册 保存 到 本 地 硬盘 上 。 其 完整 代码 如 


下 : 


import sys 


from PyQt5.QtWidgets import QWidget 


out=sys.stdout 


sys.stdout=open(r'E:\QWidget.txt' ,'w’) 
help( QTableWidget ) 


sys.stdout.close() 


sys.stdout=out 





运行 代码 后 ， 打 开 E 盘 中 的 QWidget.txt 文 件 ， 在 这 个 文件 中 即 可 查 
看 QWidget 类 的 详细 使 用 API (Application Programming Interface， 应 用 
程序 编程 接口 ) ， 如 图 1-42 所 示 。 

方法 二 : 碍 看 在 线 帮 助 文档 。 

如 果 需 要 碍 看 PyQt 5 的 详细 介绍 ， 则 可 以 访问 在 线 的 PyQt 5 说 明文 
档 ， 地 址 是 : 
http://pyqt.sourceforge.net/Docs/PyQt5/class_reference.html， 如 图 1-43 所 
不 。 


LHF) 编辑 (E) EO) 查看 (V) 帮助 (H) 
Help on class QWidget in module PyQt5. QtWidgets: 





class Widget (PyQt5. QtCore. QObject, PyQt5. QtGui. QPaintDevice) 
QWidget (parent: Widget = None, flags: Union[Qt. WindowFlags, Qt. WindowType! 
= Qt. WindowF lags ()) 


Method resolution order: 
QWidget 
PyQt5. QtCore. QObject 
sip. wrapper 
PyQt5. QtGui. QPaintDevice 
sip. simplewrapper 
builtins. object 


Methods defined here: 


acceptDrops(...) 
acceptDrops(self) -> bool 


accessibleDescription(...) 
accessibleDescription(self) -> str 


accessibleName(... ) 
accessibleName(self) -> str 


actionEvent (...) 
actionEvent (self, QActionEvent) 





图 1-42 
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1.3 Eric 6 的 安装 与 使 用 


Eric 是 一 个 全 功能 的 Python 编辑 器 和 IDE， 是 用 Python 编写 的 。 它 是 


基于 路 平台 的 Qt GUI 工具 包 、 整 合 灵活 的 编辑 器 控件 。Eric 包 含 一 个 插 
件 系统 ， 人 允许 扩展 IDE 的 功能 插件 请 从 网 上 下 载 。Eric 6 与 PyQt 5 的 结 


A 
Ho» 


非常 方便 实现 界面 与 业务 逻辑 的 分 离 ， 以 满足 Python 的 快速 GUI 开 





发 需求 ， 用 户 只 需要 关注 业务 的 逻辑 实现 ， 而 不 需要 在 界面 上 人 花 很 多 时 














间 。Eric 6 具有 如 下 优点 。 

e 跨 Windows/Linux/Mac OS 等 开发 平台 。 

e 调试 右 文 持 设 置 断 点 、 单 步调 试 、 碍 看 变量 值 等 。 

o 文 持 工 程 。 

e 文 持 自 动 补 全 ， 即 变量 输入 一 半 束 能 提示 剩 下 的 一 半 。 

o 文 持 智能 感知 ， 即 输入 变量 名 和 一 个 点 ， 就 会 自动 提示 可 能 的 函 
数 。 

e 文 持 自 动 语法 检查 ， 每 次 保存 时 都 会 进行 自动 检查 。 

e 文 持 自 动 缩 进 ， 会 自动 判断 让 、while 等 语句 。 

o 编辑 器 文 持 代码 折 和 登 。 

o 文 持 第 三 方 插件 。 

o 文 持 很 多 小 工具 ， 如 正则 表达 式 生 成 器 /测试 器 。 

o LAKH 

e 与 Qt Designer (PyQt 5 的 界面 设计 器 〉 结合 得 很 好 ， 方 便 GUI 程 
FHR. 


e 支持 代码 版 本 管理 (如 SVN 等 ) 。 
o 使 用 PyQt 5 作为 图 形 库 ， 界 面 美 观 、 大 方 。 





e 文 持 在 线 自 动 更 新 。 
工 欲 善 其 事 ， 必 先 利 其 器 。 我 们 首先 应 该 找到 一 个 趁 手 的 工具 一 一 
Fric， 可 以 说 Eric 是 开发 PyQt 的 “完美 利器 *。 本 节 重 点 介绍 Eric 6 的 使 用 
方法 。 





1. 下 载 Eric 6 

访问 Eric 官 网 : http://eric-ide.python-projects.org/， 从 
https://sourceforge.net/projects/eric-ide/files/eric6/stable/ 地 址 下 载 最 新 的 
Windows 操 作 系 统 下 的 Eric 6 安装 包 和 汉化 包 。 

截至 本 书 成 书 时 ，Eric 的 最 新 版 本 为 eric6-17.04.1， 如 图 1-44 所 示 。 





Looking for the latest version? Download eric6-17.04.1.zip (20.8 MB) 


Home / eric6 / stable / 17.04.1 


Name Downloads / Week 


4 Parent folder 


changelog 2017-04-09 13.5 kB 
2017-04-09 

eric6-17.04.1 tar.gz 2017-04-09 18.7 MB 
eric6-nolang-17.04.1.zip 2017-04-09 14.5 MB 
eric6-nolang-17.04.1 tar.gz 2017-04-09 12.3 MB 
eric6-i18n-zh_CN-17.04.1 tar.gz 586.8 kB 
eric6-i18n-zh_CN-17 04.1 zip 2017-04-09 578.7 kB 
eric6-118n-tr-17.04.1 tar.gz 2017-04-09 534.0 kB 


eric6-i18n-tr-17.04.1.zip 521.9 kB 


eric6-i18n-ru-17.04.1 tar.gz 2017-04-09 912.2 kB 





图 1-44 


2. 解 压缩 Eric 6 安装 包 和 汉化 包 
将 解压 缩 后 的 eric6-17.04.1 文 件 夹 改名 为 eric6， 将 汉化 包 解 压缩 后 
的 eric 文 件 夹 和 其 他 两 个 文件 复制 到 eric6 文 件 夹 中 ， 如 图 1-45 所 示 。 


这 台电 脑 > 新 加 卷 {E:) > installed_software 》 eric6 


eric 
changelog 

A install.py 

A install-debugclients.py 

A install-i18n.py 
LICENSE.GPL3 

a patch_modpython.py 
README, rst 
README-i18n.rst 
THANKS 

a uninstall.py 


A uninstall-debugclients.py 
图 1-45 


在 正式 安装 Eric 6 之 前 ， 还 需要 使 用 pip install 命 令 安装 Qsci 模 块 ， 
否则 会 报 出 “Error: cannot import name 'Qsci” 异 常 ， 如 图 1-46 所 示 。 


E:\install_software2\eric6-17.04.1> python install.py 
Checking dependencies 
Python Version: 3.5.3 


pyuicS 


Sorry, please install QScintilla2 and 
its PyQtS/PyQt4 wrapper. 

Error: cannot import name ‘Qsci' 
Press enter to continue... m 





图 1-46 


安装 Qsci 模 块 成 功 后 ， 如 图 1-47 所 示 。 
pip install QScintilla-i https://pypi.douban.com/simple 





图 1-47 


准备 好 安装 环境 后 ， 现 在 开始 正式 安装 Eric 6。 双 击 install.py 文件 
开始 安装 eric6-17.04.1， 或 者 在 命令 行 输入 如 下 脚本 : 
python install.py 
如 果 没 有 提示 出 错 ， 那 么 Eric 6 安装 成 功 ， 如 图 1-48 所 示 。 
安装 完成 之 后 ， 如 有 果 在 eric6 文件 夹 中 没有 生成 eric.bat SCF, W m 
要 进入 eric6\eric 文 件 夹 中 双击 eric6.pyw 文 件 ， 打 开 Eric ”6， 如 图 1-49 所 
ZN o 








te C:\windows\py.exe 


Checking dependencies 
Python Version: 3.5.3 
Found PyQtS 
Found pyuic5 
Found QScintilla2 
Found QtGul 
QtNetwork 
QtPrintSupport 
QtSql 
QtSug 
QtWidgets 
Version: 5.6.0 
Sip Version: 4.18 
PyQt Version: 5.6 
QScintilla Version: 2.9.2 
All dependencies ok. 





Cleaning up old installation 


Creating configuration file 


Compiling user interface files 
Compiling source files 
Installing eric6 

Installation complete. 


Press enter to continue.. 





图 1-48 


> zwPython > software > win-eric6 > eric6-17.01 > eric6-17.01 > eric 





EAN 修改 日 期 类 型 大 小 
EICO.dpPUaLa.xTll ZUI łn le: AIVIL X13 Ko 
eric6.desktop 15/1/18 11:5! DESKTOP sd 
eric6.e4p 人 :42 AP 文 仁 42 KB 

A eric6.Py 16/12/31 13:42 ryt Fil 13 KB 

A eric6.pyw | 

A eric6_api.py 2016/12/31 13:42 Pyt Fi 
图 1-49 





如 果 界 面 显 示 为 简体 中 文 ， 则 说 明 汉化 成 功 ， 如 1-50 所 示 。 





SHF) WE 视图 (V) FAS REO RAMU) SERA) 项 目 (P) 附加 程序 00 RMT) 窗口 (W) 书签 (8) WiL) PRIH) 
° 90 Hugg B “AOC # 4%: CO A AA BERL Owe Fre PR PE >» 


To & 


ak 


QserBacs E 项 目 浏览 器 


cid 
级 
R 
= 
ka 

m 


”文件 浏览 器 | 


版 在 控 彤 


Beet 





bjo z Q |z; WE ae.’ 
F a =p 


None 
None 
String 
None 
None 


Steam 


o 


MW Python 3.5.3 (v3.5.3:1880cb95a742, Jan 16 2017, 16 
7:02:32) [MSC v.1900 64 bit (AMD64)] on xinping, 
Standard 

\2>>> 


va 
ARARW~ TC KEARN ON 





图 1-50 


1.3.2 Eric 6 的 相关 配置 


第 一 次 打开 Eric 6 时 可 能 需要 进行 配置 。 如 果 没 有 自动 弹出 配置 窗 
口 ， 则 可 以 手动 打开 配置 窗口 : 单 击 “ 设 置 " “首选 项 ”。 
(1) 单 击 “Qt*， 在 配置 Qt Designer 栏 目 中 ， 在 “Tools Directory” X 


FESR} Fe Il 





pydqt5-tools 安 装 包 的 路 径 。pyqt5-tools 存 放 了 Qt 的 常用 工 


县 ， 使 用 pip install 命 令 安 装 成 功 后 ， 存 放 在 %\python35\Lib\site-packages 
目录 下 ， 如 图 1-51 所 示 。 


@ CORBA 
@ IRC 
I MIME 类 型 
@ Python 
@a 
> Web 
虽 安全 
> 版 本 控制 
/ 8 帮助 
/ 编辑 器 
Q 插件 管理 器 
= 打印 机 
电子 邮件 
, a 界面 
S ao 
ow 模板 
TES 
WV 日 志 浏 览 器 
A 十 六 进 制 编辑 器 
， 久 调试 器 
@ 通知 
22 图 标 
F A 图 形 
P mae 











Reset 


配置 Qt 


Qt MEN 
注意 : 该 设置 将 在 下 次 启动 应 用 程序 时 生效 。 
IE:\installed softvare\python35\Lib\site-packages\PyQt5\translations @ [= 


Note: Leave this entry empty to use an envirornent variable or the path 
conpiled into the Qt library. Environment variables supported are 


© QT4TRANSLATIONSDIR for Qt4 
e QTSTRANSLATIONSDIR for Qt5 
e QTTRANSLATIONSDIR for any Qt variant 


Qt 工具 


Tools Directory: |ed_softvare\python35\Lib\site-packages \pyat5-tools Cts 


The tool executablgfis composed of the prefix, the tool nane and the 
postfix. For wi the extension is added automatically. 


Qt-Prefix: fF ___| Qt-Postfix: _ Sample: designer 


pyuic /“pyside-uic 选项 
缩 进 宽度 : 4/5 


See y 
. 


[C] Generate inports relative to 





图 1-51 


(2) 单 击 “编辑 器 ” 3“ 自 动 完 成 ” a “QScintilla”, 分 选 “ 显 示 单 


和 “使 用 填 


符号 ” 复 选 枉 ， 如 图 1-52 所 示 。 


输入 搜索 内 容 … 
Æ CORBA 
@ IRC | v 显示 单条 v) 使 用 境 充 符号 
MIME 类 型 源 文件 
a a © 从 文档 O 从 apr 文件 O 从 文档 和 arr 文件 
> & Web Browser 
第 安全 
， 版 本 控制 系统 
> @ 帮助 
4 / 编辑 器 
i API 
® Mouse Click H... 
O% 查找 
章 代 码 检查 器 
L WES 
T 高 亮 功能 
SS 键盘 给 入 
等 拼写 检查 
$a 
，“ 调用 提示 
A 通用 配置 
bed 文件 处 理 
44 自 动 完成 
@ Qscintilla 


Configure QScintilla Coapletion 




















图 1-52 





(3) 单 击 “编辑 器 ”~ “自动 完成 >， 勾 选 “启用 自动 补 全 ” 复 选 框 ， 如 
图 1-53 所 示 。 





£ 首选 项 =E 


Ø CORBA | 
编 IRC [| 启用 自动 补 全 

MIME 类 型 通用 配置 
@® Python 回 区 分 大 小 写 J BAF 
@a ; 
K Web Browser ae: 
z =f 





= Configure Coapletion Support 


Mal 


Plug-In Behavior 


© 帮助 [M] Show QScintilla completions, if plug-ins fail 


Mouse Click H.. 
AER 
6 RRS 
T 高 亮 功 能 
EIRA 
Y 拼写 检查 
输出 器 
。 调用 提示 
A 通用 配置 
园 文件 处 理 
4 \ 自动 充 成 
@ Qscintilla 
at FERRE 
m 打印 机 


he 一 Do 


Reset OK Cancel Apply 











图 1-53 


进行 了 上 面 配置 后 ，Eric 6 就 有 了 智能 提示 功能 。 

(4) 单 击 “编辑 器 ” “API”， 语 言 选择 “Python3”， 然 后 单 击 “ 从 已 
安装 的 API 中 添加 ”按钮 ， 从 E:\installed_software\python35\Lib\site- 
packages\PyQt5\gsci\api\python 导 入 eric6.api， 单 击 “ 编 译 API” 按 钮 ， 最 后 
单 击 “OK” 按 钮 ， 如 图 1-54 所 示 。 





输入 搜索 内 容 … | 配置 API 文件 
CORBA “|| 
@ IRC M 自动 编译 API 
MIME 类 型 | A 
Bron | 语言 : pythons 
@a Project Type: Eric6 插件 


& Web Browser API 

H a ie E:\installed_software\python35\Lib\site-packages\PyQt5\qsci\api\python\eric6.< 
Ə =m | 
(=) 7 sa 
[E ari 


D Mouse Click Handlers 

















Enter Path Nane č 
从 已 安装 的 API 中 添加 
从 插件 api 中 添加 





























图 1-54 


还 要 选择 PyQt 5 的 API， 如 图 1-55 所 示 。 


配置 &PI 文件 
V 自动 编译 API 


语言 : (Æ Python3 


Project Type: |PyQt5 GUI 
& Web Browser API 
= 安全 ed_software\python35\Lib\site-packages\PyQt5\qsci\api\python\eric6.api _ 
”图 版 本 控制 系统 ed_software\python35\Lib\site-packages\PyQt5\qsci\api\python\Python-3.5.api | 
; ed_software\python35\Lib\site-packages\PyQt5\qsci\api\python\QScintilla2.api 
aa ed_software\python35\Lib\site-packages\PyQt5\qsci\api\python\PyQt5.api 
© Mouse Click Handlers 














Enter Path Nane 
从 已 安装 的 API 中 添加 
从 插件 PI 中 添加 























图 1-55 


配置 Python 使 用 的 编码 格式 为 “atf-8”， 避 免 应 用 出 现 乱码 ， 如 图 1- 
56 所 示 。 


输入 搜索 内 容 … 


配置 Pyth 
Ø CORBA sme a ata 


@ IRC 编码 
MIME 类 型 字符 串 编码 : utf-8 


$ > I/O 编码 : utf-8 
> & Web Browser 源 代码 关联 








Enter the file extensions to be associated with the Python versions 
separated by a space. They must not overlap with each other. 





Python 2: Í. py2 .py¥2 .ptl 
Python 3: |. py .pyw .py3 .pyw3 


Python 2 解释 器 
请 在 “Python 2 调试 器 ”页 面 配 置 Python 2 解释 器 。 


P 十 六 进 制 编辑 路 
” 意 调试 时 

@ iu 

23 图 标 

te 图 形 

P 托盘 启动 器 

@ 网 络 
, 置 项 目 

AE 


_ Reset | OK | Cancel || Apply | 


图 1-56 




















(5) 单 击 “项 目 ”… “多重 项 目 ”， 在 “工作 区 ”区 域 通过 单 击 最 右 侧 的 
图 标 选择 一 个 位 置 ， 这 里 选择 的 是 E:\testPyQt5 文 件 夹 ， 然 后 单 
击 “OK” 按 钮 ， 如 图 1-57 所 示 。 





= 配置 多 重 项 目 设 定 

工作 区 

E:\testPyQt5 

主 项 目 

Iv] 自动 打开 主 项 目 

XML 

Vi 在 与 XML 文件 相关 的 多 重 项 目 中 包含 时 间 信 息 
最 近 的 多 重 项 目 

最 近 打开 多 重 项 目的 数量 : oF 











图 1-57 


这 样 简单 配置 后 ， 我 们 就 可 以 使 用 Eric 6 来 体验 极速 GUI 开发 了 。 
(6) 设置 代码 风格 。 单 击 “ 编 辑 器 ” - “风格 ”， 在 “缩放 ”区 域 通过 拖 
动 “Initial zoom factor” 滑 块 来 设置 展示 代码 的 默认 大 小 ， 如 1-58 所 示 。 











(7) Eric 6 语法 错误 提示 。Eric 


志 ， 如 图 1-59 所 示 。 








Initial zoon factor: 


Annotations 


Show annotations 
Warnings 








Foreground | Background L Foreground | Background 


Warning: There night be an issue. | Error: There is an issue. 


风格 
Foreground | Background 
Style: There is a style issue. 








Change Tracing 

[_] Mark changed lines 

Tineout for marking changed lines: 500% $ 

Unsaved changes colour: =a | Saved changes colour: 


Vhitespace 


| 





图 1-58 








6 语法 错误 提示 会 有 一 个 昆虫 标 























jedi 是 一 个 超级 棒 的 Python 上 自动 补 全 库 ， 可 以 在 IDE 或 者 文本 编辑 器 
中 使 用 。jedi 好 用 并 且 快 速 ， 它 理解 所 有 的 Python 基础 语法 元 素 ， 包 括 
许多 内 建 函 数 。 除 此 之 外 ，jedi 还 文 持 两 种 不 同 的 goto 功 能 、 重 命名 、 
pydoc 和 一 些 与 IDE 有 关 的 特性 。 

jedi 可 以 在 很 多 编辑 器 中 使 用 ， 主 流 的 有 Eric IDE, Vim, Emacs, 
Sublime Text. TextMate、Kate、Atom、SourceLair、GNOME Builder, 
Visual Studio Code, Gedit, wdb=. 

1.2248 jedi 

使 用 以 下 命令 安装 jedi。 

pip install jedi 
如 果 安 装 成 功 ， 则 会 显示 如 图 1-60 所 示 的 信息 。 


D:\installed_software\Python34\Scripts>pip install jedi 
ecting jedi 


T 


Coll 
Do 


Inst 


wnloadin di-0.10.0- 


i 
100% I ee ee) 


alling collected packages: j 


3-none-any.whl (186kB) 


PE a tt bt a Lt ae 


edi 


Successfully installed jedi-0.16.0 


to 
3, 


2. 为 Eric 6 安装 jedi 插 件 
为 了 使 Fric 
打开 Eric 

如 图 1-61 至 图 1-64 所 示 。 


名 称 
稳定 


作者 : 
URL: 


网 络 
仓库 


API Files 

Assistant, Eric6 

Checkers, PyLint 

Checkers, Vulture 

Completions, Jedi 

Documentation Set, PyQt 4.11 
Documentation Set, PyQt 4.12 
Documentation Set, PyQt 5.6 
Documentation Set, PyQt 5.7.1 
Documentation Set, Python 2.7.13 @ 1.0.0.1 
Documentation Set, Python 3.4.5 1.0.0 


This plug-in provides an alternative code completion and calltips provider. 
junp to the place a nane is defined through a configurable mouse click conbination. The information is 
deternined by the Jedi library included in the plug-in. 


https://eric-ide. python-projects. 


状态 : TERR 
URL: 


6 的 目 动 补 全 功能 更 加 完善 ， 现 在 为 Eric 
6， 选 择 荣 单 “ 插 件 ” -~ “插件 储存 库 ” 进行 jedi 插 件 的 安 





图 1-60 


6 安装 jedi 插 


简要 描述 


API files for Auto-Completion and Calltips. 

Alternative code completion provider. 

Interface to the pylint checker program. 

Checker for unused code. 

Alternative code completion provider using the Jedi library. 

Plug-in providing the PyQt 4.11 documentation in QtHelp format. 

Plug-in providing the PyQt 4.12 documentation in QtHelp format. 

Plug-in providing the PyQt 5.6 documentation in QtHelp format. 

Plug-in providing the PyQt 5.7 documentation in QtHelp format. 

Plug-in providing the Python 2.7.13 documentation in QtHelp format. 

Plug-in providing the Python 3.4.5 documentation in QtHelp format. 
> 


It includes the capability to 


Detlev Offenbach <detlev@die-offenbachs. de> 


org/plugins6/stable/PluginConpletionJedi. zip 


https ://eric-ide. python-projects. org/plugins6/repository. xnl 


更 新 


下 载 并 安装 关闭 与 安装 





输入 要 安装 的 插件 存档 





CAUsers\wangshuo\_eric6\Downloads\PluginCompletionJedi-1_0_4.zip 











安装 摘要 


Plugin ZIP-Archives: 
C:\Wsers\wangshuo\_eric6\Downloads\PluginCompletionJedi-1_0_4. zip 
Destination: 


用 户 插件 文件 夫 (C:\Wsers\wangshuo\_eric6\ericéplugins) 


0/100 文件 
eee] T> [sie] one 


图 1-63 





安装 摘要 





re C:\Users\wangshuo\_eric6\Downloads\PluginCoapletionJedi-1_0_4. zip … 
AE 


插件 安装 成 功 。 








ES 25/22: 


ToS 安装 Close |. 





图 1-64 
1.3.4 测试 Eric 6 


在 Eric 6 中 新 建 .py 文件 ， 输 入 如 图 1-65 所 示 的 代码 并 运行 ， 弹 出 
口 即 说 明 Eric 6 安装 成 功 了 。 


Bi 


import sys 
from PyQtS.QtWidgets import QWidget, QApplication 


sys.exit(app.exec_()) | 





图 1-65 
1.3.5 Eric 6 的 基本 使 用 


这 一 节 主 要 讲解 使 用 Eric 6 开发 PyQt 5 应 用 。 下 面 的 例子 文件 保 


存在 PyQt5/Chapter01/EricPro01 目 录 下 。 


(1) 建立 PyQt 5 项 目 。 打 开 Eric 6， 选 择 菜 单 “ 项 目 ” ~ “新建 >， 如 
1-66 所 示 。 





文件 (F) 


编辑 (E) 视图 (V) 开始 (5) 调试 (D) 单元 测试 (U) 多 重 项 目 (M) | 项 目 (B) | 附加 程序 (X) 设置 (T) 
Pao dans e 
















BOW) 书签 (8) 插件 (L) 帮助 (H) 
UD 和 ig TA A E: 
| ; æ ; 
Yo 业已 | 二 _@ L HRO- 
= 名 称 版 本 控制 系统 状 过 打开 最 近 的 项 目 
> 关闭 (C) 
m 
图 1-66 





(2) 填写 项 目 信 息 ， 然 后 单 击 “OK” 按 钮 ， 如 图 1-67 所 示 。 以 下 为 
本 例 项 目 信息 。 


项 目 名 称 : FirstPyQtPro 
项 目 类 型 : PyQt5 GUI 


项 目 文 件 夹 : E:\quant\PyQt5\Chapter01\EricPro01 (可 以 选择 本 地 硬 
盘 上 的 任意 文件 夹 ) 





(3) 弹出 一 个 窗口 ， 问 是 否 要 添加 已 有 文件 到 项 目 中 ， 通 党 单 
击 “No” 按 钮 ， 如 1-68 所 示 。 


mA See : 


项 目 语言 (P) : 


项 目 类 型 (T) : 
项 目 文件 夹 (0) : 
版 本 号 (WD : 
SHIA GD : 


行 示 字符 (D) : 
作者 (2) : 
电子 邮件 CE) : 
描述 (D) : 


| 拼写 检查 属性 … 
Python’ 

口 混合 编程 语言 (x) 

‘PyQt5 GUI 

















E:\quant\PyQt5\Chapter01\EricPro01 
0.1 

















Enter Path Name 














系统 默认 





























图 1-67 


# eric6 - New Project 


iar sepa 





图 1-68 


(4) 新 建 一 个 Python LF. WARRE P > “TEE”, Eric 会 新 
娃 一 个 名 为 “无 标题 ”的 标签 ， 但 在 项 目 浏览 器 中 并 没有 “无 标题 1*"， 如 
图 1-69 所 示 。 


Fa FirstPyQtPro - eric6 
文件 (F) ”编辑 (E) MEV) 开始 (S) 调试 [D) 单元 测试 (U) 多 重 项 目 (M) 项 目 (P) 附加 程序 (X) 设置 (T) BOW 书签 (8) 播 件 (L) 帮助 (H) 

= O wdav GB ~ cs % 4 b oul ww y 
Vig 2 ly- © 天 标题 p 
a | 名 称 版 本 控制 系统 状 式 
把 a init__.py 
g 


多 重 项 目 浏览 器 





浏览 器 


图 1-69 





G) 单 击 工具 栏 中 的 “另存 为 图标， 将 “无 标题 1 保存 成 .py 格式 的 
文件 ， 如 1-70 所 示 。 





F ps =F z 
r. FirstPyQtPro - eric6 
文件 (F) SAE 视图 (V) 开始 (S) 调试 [D) 单元 测试 (U) 多重 项 目 (M) WEP) ”附加 程序 (X) 设置 (T) BOW BAB) 播 件 (L) 帮助 (H) 
Vio @ | 区 t @ 无 标题 1 E 


1 


项 目 浏览 器 





图 1-70 





(6) 在 保存 文件 对 话 框 中 ， 输 入 要 保存 的 文件 名 FirstWin.py， 保 
存 类 型 选择 “Python3 Files(*.py)”， 然 后 单 击 “保存 ”按钮 ， 如 图 1-71 所 
示 。 


个 di « quant > PyQtS » Chapter01 » EricPro01 


收 改 日 期 


J. _eric6project 2017/5/29 14:43 
a) _init_.py 2017/5/29 14:43 


& Windows8_OS (t 
多 新 加 卷 (D:) 
ow 新 加 卷 (E:) 


@ ms 
v < 


文件 名 (N): FirstWin.py 
保存 类 型 (T): Python3 Files (*.py) 





~ 隐藏 文 件 夹 





图 1-71 


“无 标题 1* 已 变 成 刚 输入 的 名 称 ， 并 且 为 .py 格式 ， 项 目 浏 览 器 中 也 
有 了 该 文件 ， 如 1-72 所 示 。 





文件 (F) 编辑 (E) 视图 (V) 开始 (S) 调试 (D) 单元 测试 (U) 多 重 项 目 (M) 项 目 (P) 附加 程序 (X) 设置 (T) 





























BOW) ”书签 (8) 播 件 (L) 帮助 (H) 

o 0S0 HUJUI XOCKR#RK'COZE AE RARUA WOW GSE DOE DE HE 
Yo A le ¢ | py } | m C] Firstyin.py B 

名 称 版 本 控制 系统 状 臣 poms z 
路 一 | n 
iR | > | init__.py | 1 
zm A FirstWin.py | 
x 

图 1-72 


在 文件 FirstWin.py 中 输入 以 下 脚本 ， 然 后 单 击 工具 栏 中 的 “保存 ?图 
标 进行 保存 。 
import sys 
from PyQt5.QtWidgets import QPushButton,QApplication, QWidget 
class WinForm( QWidget): 


def _init (self,parent=None): 
super(WinForm,self).__init__ (parent) 
self.setGeometry(300,300,350,350) 
self.setWindowTitle(' 点 击 按钮 关闭 窗口 ") 
quit=QPushButton('Close',self) 
quit.setGeometry(10,10,60,35) 
quit.setStyleSheet("background-color: red") 
quit.clicked.connect(self.close) 

if_ name ==" main ": 

app=QApplication(sys.argv) 

win=WinForm() 

win.show() 

sys.exit(app.exec_()) 

单 击 某 单 “开始 ” = “运行 脚本 >”， 就 可 以 运行 刚才 保存 的 脚本 了 ， 如 
1-73 所 示 。 





文件 (F) RME 视图 (V) | 开始 (5) | 调试 (D) 单元 测试 (U) 多 重 项 目 (M) 项 目 (P) 附加 程序 (X) 设置 (0) 窗口 (W) HEB) HHL RH) 
9S0 khl #4K COAR 4A BARAA wee s9 Pee 
@ Restart 
Lio e te. hi an First¥in. py O 
名 称 Wingora_ = 
a _init_.py $ ~-* coding: utf-8 -*- 
= | 4 FirstWinpy 
四 
@ imports a 
4 多 WinForm(Q\ 
8 Class Att 
b _init_(c@ 


import sys 
from PyQt5.QtWidgets import QPushButton, QApplication, QWidget 





class WinForm( QWidget) : 

def init (Eeif, parent = None): 
super (WinForm,Se]f).__init__ (parent) 
Belfl.setGeometry(300, 300, 350, 350) 
EelI 蛋 .setWindowTitle' 点 击 按钮 关闭 窗口 ') 
quit = QPushButton('Close'’, 
quit.setGeometry(10, 10, 60, 35) 
quit .setStyleSheet ("background-color: red") 
quit.clicked. connect Gelfi.close) 


OPNEMEN 


pii 
把 
2 
m 
‘x 
= 
HA 
il 


= mm "_ main ": 

app = QApplication(sys.argv) 
win = WinForm() 

win.show() 
sys.exit(app.exec_()) 


>» 模板 浏览 器 





图 1-73 


如 果 能 弹出 如 图 1-74 所 示 的 窗口 ， 则 说 明 脚 本 运行 成 功 。 


x 





图 1-74 


1.4 SRE 


本 书 程序 存放 在 GitHub 上， 通过 访问 
https://github.com/cxinping/PyQt5 地 址 (注意 字母 大 小 写 ) 手动 下 载 。 

或 者 通过 下 面 的 方式 获得 完整 的 代码 。 

首先 ， 访 问 Git 官 网 https://git-scm.com/download/win 下 载 安装 软件 
Git-1.9.4-*.exe. 

然后 ， 在 本 地 硬盘 上 新 建 一 个 文件 来 ， 比 如 E:/temp2， 在 文件 夹 中 
单 击 鼠 标 右键 ， 在 弹出 的 快捷 荣 单 中 选择 “Git Bash”， 如 图 1-75 所 示 。 








* 显示 卡 履 性 

$ ”配置 可 交换 显示 卡 
查看 (V) 
排序 方式 (O) 
分 组 依据 (P) 
刷新 (E) 
自 定义 文件 卖 (F).… 


粘贴 (P) 


粘贴 快捷 方式 (S) 
撤消 复制 (U) Ctrl+Z 


Git Init Here 
| Git Gui 
Git Bash 
共享 (H) 
新 建 (W) 
属性 (R) 





图 1-75 


最 后 ， 在 弹出 的 cmd 窗 口中 输入 以 下 命令 : 
git clone https://github.com/cxinping/PyQt5.git 
如 条 看 到 如 图 1-76 所 示 的 命令 提示 ， 束 说 明 下 载 成 功 了 。 


E:\temp2> git clone https://github.com/templarXxplis/PyQt5.git 
Cloning into ‘PyQtS’... 

remote: Counting objects: 13, done. 

remote: Compressing objects: 100% (11/11), done. 


remote: Total 13 (delta 0), reused 13 (delta 0), pack-reused 0 
Unpacking objects: 100% (13/13), done. 
Checking connectivity... done. 





图 1-76 


如 果 下 载 有 问题 ， 请 发 送 电子 邮件 联系 笔者 ， 邮 箱 为 
xpws2006@163.com， 邮 件 主题 为 “PyQt5 代 人 码 ”。 
成 功 执行 git 命 令 后 ， 就 把 程序 下 载 到 本 地 了 ， 如 图 1-77 所 示 。 


IX} 
+ 


称 SHAE ser K 


.git 
Chapter01 20 :} 9:26 rit 
Chapter02 2017/7/7 17:0 Sts 
Chapter03 2017/8/7 10:26 anaes 
Chapter04 
Chapter05 
Chapter06 é 2 
Chapter07 2c 8/7 10:3 sees 
Chapter08 2017/8/7 10:38 ote 
Chapter09 2017/8/27 19:54 44st 
Chapter10 917/8/7 10:42 yit 
Chapter11 
tool 

加 README.md 


图 1-77 
本 书 配套 程序 的 工作 目录 是 PyQt5， 主 要 存放 案例 脚本 源码 。 有 关 


的 程序 如 果 有 改变 ， 则 会 在 GitHub 上 发 布 更 新 ， 请 读者 手动 下 载 。 如 果 
己 经 使 用 git clone 命 令 下 载 了 全 部 案例 脚本 源码 ， 则 可 以 使 用 git pull 命 


令 更 新 脚本 。 

PyQt5 目 录 结 构 中 的 子 目录 说 明 如 下 。 

e \PyQt5\Chapter*\: 这 些 目录 是 最 重要 的 ， 存 放 本 书 11 个 章节 中 讲 
解 的 PyQt 5 所 有 知识 点 对 应 的 案例 脚本 。 








第 2 蔓 Pvthon 基 本 话 ; 


2.1 Python 简介 








Python 是 最 适合 初学 者 使 用 的 编程 语言 ， 它 也 是 目前 开行 业 唯 一 的 
入 门 简单 、 功 能 强大 的 商业 级 开发 平台 。 事 实 上 ，Python 已 经 超越 普通 
的 编程 语言 ， 几 乎 成 为 IT 行业 万 能 的 开发 平台 。 
(1) 入 门 简单 。 任 何 熟悉 JS 脚本 、VB、C、Delphi 的 用 户 ， 通 常 
一 天 即 可 学 会 Python。 即 使 是 不 会 编程 的 设计 师 、 打 字 员 ， 一 周 内 也 能 
熟练 掌握 Python， 其 学 习 难 度 绝对 不 会 比 学 习 Photoshop、 五 笔 打 字 难 
度 大 。 
(2) 功能 强大 。 海 量 级 的 Python 模块 库 提 供 了 IT 行业 最 前 沿 的 开 
发 功能 。 
e 大 数据 : pandas、Numpy 库 已 经 逐步 碾 压 R 语 言 。 
e CUDA: 高 性 能 计算 ，Python、C (C++) AIFORTRANZENVIDIA 
方 认 可 的 三 种 编程 语言 ， 也 是 目前 唯一 适合 PC 平台 的 CUDA 编 程 工 


D 
o 








B 
A 
e 机 器 学 习 : scikit-learn、Theano、pattern 是 国际 上 最 热门 的 机 器 学 
习 平 台 。 
e 上 自然 语言 : NLTK， 全 球 首 选 的 自然 语言 处 理 平台 ; spaCy， 工 业 
级 NLP 平 台 。 
e 人 脸 识 别 : 使 用 Python 的 OpenCV 库 ， 可 以 轻松 、 高 效 地 实现 图 





片 中 的 人 脸 检 测 、 有 眼睛 检测 和 笑脸 检测 。 

o 游戏 开发 : pygame 提供 了 图 像 、 音 频 、 视 频 、 手 柄 、AI See 
游戏 开发 模块 库 。 

e 字体 设计 : fontforge 是 唯一 的 商业 级 字体 设计 开源 软件 ， 其 内 置 
的 脚本 和 底层 核心 的 fonttools 都 是 用 Python 开发 的 。 

e 电脑 设计 : Blend, GIMP, Inkscape, Maya, 3D Max 都 内 置 或 扩 
展 了 Python 语言 支持 。 

(上 面 提 到 的 pandas、CUDA、scikit-learn、Theano、pattern， 是 
Python 模块 库 或 IT 行业 术语 。) 

Python 是 由 荷兰 计算 机 程序 员 Guido van Rossum 〈 吉 多 : 范 罗 苏 姆 ) 
开发 的 ， 他 对 Python 的 目标 是 : 

e 一 门 简单 、 直 观 的 语言 ， 并 与 主要 竞争 者 一 样 强大 。 

e 开源 ， 以 便 任 何人 都 可 以 为 它 做 贡献 。 

o 代码 像 纯 英语 那样 容易 理解 。 

e 适用 于 短期 开 友 的 日 党 任务 。 

Python 是 一 种 学 习 简 单 、 功 能 强大 的 工业 级 编程 语言 ， 也 是 一 种 真 
正 的 终 丑 编程 语言 ， 适 合 8 岁 到 80 岁 的 用 户 学 习 编 程 ， 是 小 学 生 和 博士 
生 通 用 的 编程 语言 。2011 年 1 月 ， 在 TIOBE 编 程 语言 排行 榜 中 ，Python 
被 评 为 2010 年 度 语言 。 

提示 

TIOBE 编 程 语言 排行 榜 是 编程 语言 流行 趋势 的 一 个 指标 ， 每 月 更 新 
一 次 ， 这 个 排行 榜 排 名 基于 互联 网 上 有 经 验 的 程序 员 、 诬 程 和 第 三 方 三 
商 的 数量 ， 排 名 是 使 用 著名 的 搜索 引擎 (如 Google、MSN、Yahool、 
Wikipedia、YouTube 以 及 Baidu 等 ) 进行 计算 的 。 请 注意 ， 这 个 排行 榜 
只 是 反映 某 种 编程 语言 的 热门 程度 ， 并 不 能 说 明 它 好 不 好 ， 或 者 它 所 编 
写 的 代码 数量 多 少 。 

Python 是 一 种 动态 语言 ， 文 持 交 互 式 编程 、 面 癌 对 象 编程 和 函数 式 





























Site, FAR. Pea, mH, Ze CList) 、 字 典 (Dictionary) 和 
元 祖 (Tuple〉 等 数据 类 型 。 从 2017 年 6 月 编程 语言 排行 榜 TOP20 榜 单 来 
看 ，Python 编 程 语言 在 兵器 谱 上 排名 第 四 ， 前 三 名 分 别 是 Java、C 和 
C++， 如 图 2-1 所 示 。2017 年 6 月 ， 江 湖上 人 称 “ 四 哥 ” 的 ， 就 是 Python 大 
侠 。 











Jun 2017 Jun 2016 Change Programming Language Ratings 
Java 14.493% 
C 6.848% 
C++ 5.723% 
Python 4.333% 
C# 3.530% 
Visual Basic .NET 3.111% 
JavaScript 3.025% 
PHP 2.774% 
Peri 2.309% 
Assembly language 2.252% 
Ruby 2.222% 
Swift 2.209% 
DelphiObject Pascal 2.158% 
R 2.150% 
Go 2.044% 
Visual Basic 2.011% 


MATLAB 1.996% 


Objective-C 1.957% 


Scratch 1.710% 


PL/SQL 1.566% 





图 2-1 








python 语法 是 编程 语言 基础 中 的 基础 ， 即 使 你 是 一 位 有 经 验 的 程序 
员 ， 再 看 看 这 些 Python 编程 语法 ， 也 会 对 Python 语言 的 细节 有 更 多 的 
Wik. 


2.2 数据 类 型 


Python 有 5 种 基本 数据 类 型 : 
e Number (数字 ) 
e String CFFE ) 
o List JJK) 
e Tuple (元 组 ) 
e Dictionary (Hh) 
注意 
(1) Python 的 数据 类 型 和 C 语言 的 不 同 ， 其 有 复数 形式 ， 比 如 
(-6+4j) 和 (5.3-7.6j)。 
(2) Python 没 有 char 单 字符 类 型 。 
数字 类 型 用 于 存储 数值 。 
当 给 一 个 变量 赋值 时 ，Number 数 据 类 型 就 会 被 创建 : 
x=1 
y=911 
Python 文 持 4 种 不 同 的 数字 类 型 : 
o int 《有 符号 整 型 ) 
o long 《长 整 型 ， 也 可 以 代表 八进制 和 十 六 进 制 数 ) 
o float CF AW) 
e complex (复数 ) 
Python 香 用 的 计算 符号 有 : 
e +， 加 法 。 
e-， 城 法 。 


e +， 乘法 。 
e /， 除 法 。 
e //， 整 除 。 
e %， 取 模 ， 余 数 。 
eo, RY 


案例 2-1 基本 运算 


案例 2-1 文 件 名 为 py201math.py， 保 存 路 径 为 
PyQt5/Chapter02/py201math.py， 主 要 介绍 Python 数值 的 基本 运算 。 其 核 
心 代码 如 下 : 

#1 

print(\n#1') 

x=10 

y=22 

Z=35 
print('x,y,Z,',X,Y,Z) 

#2 

print(‘\n#2’') 
a=x+y;print('a=x+y,',a) 
b=x-y;print('b=x-y,',b) 
c=z-x*y;print('c=z-x*y,',c) 
#3 

print(‘\n#3') 
a=z/x;print('a=Z/x,',a) 
b=z//x;print('b=z//x,',b) 


c=zZ%x;print('c=z%x,',C) 


#4 

print(\n#4') 

a=x**2;print(‘a=x**2,',a) 

b=x**3;print('‘b=x**3,',b) 
对 应 的 输出 信息 如 下 : 

#1 

X,y,Z,10 22 35 

#2 

a=xty,32 

b=x-y,-12 

C=Z-x*y,-185 

#3 

a=z/x,3.5 

b=z//x,3 

c=2%x,5 

#4 

a=x**2,100 

b=x**3,1000 


2.3 String〈 字 符 串 ) 


字符 串 是 由 数字 、 字 母 、 下 画 线 组 成 的 一 串 字 符 ， 一 般 采 用 单 引 号 
或 者 双 引 号 的 形式 : 
str="abcd' 
str="hello ziwang.com" 
Python 语言 的 字符 串 类 似 于 传统 语言 的 字符 数组 模式 ， 也 可 以 看 作 
字符 列表 ， 有 两 种 取 值 顺序 : 
e 从 左 到 右 索 引 默 认 从 0 开始 ， 最 大 范围 是 字符 串 长 度 少 1。 
e 从 右 到 左 索引 默认 从 -1 开始 ， 最 大 范围 是 字符 串 开 头 。 
如 果 要 实现 从 字符 串 中 获取 一 段子 字符 串 的 话 ， 使 用 变量 [ 头 下 标 : 
尾 下 标 ]， 就 可 以 截取 相应 的 字符 串 ， 其 中 下 标 是 从 0 开始 算 起 的 ， 可 
以 是 正 数 或 负数 ， 下 标 可 以 为 空 ， 表 示 取 到 头 或 尾 。 


案例 2-2 FE AT 








案例 2-2 文 件 名 为 py202str.py， 保 存 路 径 为 
PyQt5/Chapter02/py202str.py， 主 要 介绍 字符 串 的 基本 用 法 。 其 核心 代码 
如 下 : 

dss='hello pyqt5' 
print('dss',dss) 

#1 

print(\n#1') 
s2=dss[1:];print('s2,',s2) 
s3=dss[1:3];print('s3,',s3) 


s4=dss[:3];print('s4,',s4) 
#2 
print(‘\n#2') 
s2=dss[-1];print('s2,',s2) 
s3=dss[1:-2];print('s3,',s3) 
dn=len(dss);print(‘dn,',dn) 
#3 
print(‘\n#3') 
print('s2+s3,',s2+s3) 
print('s3*2,',s3*2) 

对 应 的 输出 信息 如 下 : 
dss hello pyqt5 
#1 
s2,ello pyqt5 
s3,el 
s4,hel 
#2 
s2,5 
s3,ello pyq 
dn,11 
#3 
s2+s3,5ello pyq 
s3*2,ello pyqello pyq 

在 字符 串 运 算 中 ， 加 号 〈+) 是 字符 串 连接 运算 待 ， 乘 号 〈*) 表示 

重复 操作 。 


案例 2-3 字符 串 常 用 方 ; 


Python 语言 的 字符 串 其 实 是 一 种 对 象 ， 内 置 了 大 量 实用 的 字符 串 函 
数 和 方法 ， 几 乎 包括 了 所 有 常用 的 Python 字符 串 操 作 ， 如 字符 串 的 蔡 
PR. ABR. BR. Berl, HERE. LOR. ER OS. 

案例 2-3 文 件 名 为 py203str2.py， 主 要 介绍 字符 串 内 置 函 数 和 方法 
的 ， 所 以 程序 代码 较 长 ， 我 们 分 组 进行 说 明 。 


#1 #1, 去 空格 及 特殊 符号 
dss=' hello pyqt$,,' sl, hello pyqt5 
print(\n#1, 去 空格 及 特殊 符号 ') 

sl=dss.strip().lstrip().rstrip(',') 


print('s1,',s1) 





#2 #2, 字 符 串 连接 


print("\n#2, 字 符 串 连接 ') s2,a hello pyqt5,,. hello pyqt5,,c 


s2=dss.join(['a’,'.’,'c']) s3, S3XX 
print('s2,',s2) 
s3='s3' 


s3t="'xx' 





print('s3,',s3) 


对 应 的 输出 信息 


print(\n#3, 查 找 字符 ') 
css='abc1c2c3' 
pi=css.find('c') 
print('pi,',pi) 


#4, 字 符 串 比较 #4, 字 符 串 比较 
print(\n#4, 字 符 串 比较 ') True 

print( s1 > s2 ) False 

print( sl = s2 ) False 

print( sl < s2 ) 


#5, TIF ERKE 
print(\n#5, FIF EKE) len(s1), 3 
sl,s2='abc','c123' len(s2), 4 
print(‘len(s1),',len(s1)) 
print(‘len(s2),',len(s2)) 


#6, 大 小 写 转换 
print(\n#6, 大 小 写 转换 ') 大 写 ，sl.upper0,ABC 
s1,S2='abc',,ABC123efg' 小 写 ，s2.lower(), abc123efg 
print(' 大 写 ，sl1.upper(),',sl.upper()) 大 小 写 互 换 ,s2.swapcase(), abc123EFG 
print(/)\5, s2.lower(),',s2.lower()) 首 字母 大 写 ,sl.capitalize(), Abc 
print(' 大 小 写 互 换 ,s2.swapcase(),',s2.swapcase()) 


print(' 首 字母 大 写 ,s1.capitalize(),',s1.capitalize()) 


#7, 分 割 字 符 串 
print(\n#7, 分 割 字 符 串 ') s2.split, [' hello', ' ziwang', 'com', ", "] 


s2=' hello, ziwang,com,,' 





print('s2.split,',s2.split(',')) 


2.4 List JIK) 


列表 用 [ ] 标 识 ， 是 Python 中 最 常用 的 数据 类 型 。 列 表 类 似 于 传统 语 
言 中 的 数组 ， 但 它 更 加 灵活 、 强 大 。 

IRLEF BF. PAT, ERODE SHIRE) 。 

PZ BETD TC AB TS, RVI RS], BNR 
引 是 0， 第 二 个 索引 是 1， 依 此 类 推 。 从 右 到 左 索 引 默 认 从 -1 开始 ， 下 
标 可 以 为 空 ， 表 示 取 到 头 或 尾 。 














案例 2-4 列表 操作 
案例 2-4 文件 名 为 py204list.py， 保 存 路 径 为 


PyQt5/Chapter02/py204list.py， 主 要 介绍 列表 的 基本 用 法 。 其 核心 代码 
如 下 : 
#1 
print(\n#1') 
zlst=[‘hello','PyQt5’,’.’,"com'] 
vist=['Top','Quant',’.','vip'] 
print(‘zlst,',zlst) 
print(‘vlst,',vlst) 
#2 
print(\n#2') 
s2=zlst[1:];print('s2,',s2) 
s3=zlst[1:3];print('s3,',s3) 
s4=vlst[:3];print('s4,',s4) 


#3 
print(‘\n#3') 
print('s2+s3,',s2+s3) 
print('s3*2,',s3*2) 
对 应 的 输出 信息 如 下 : 
#1 
zlst,['hello',PyQt5','.,'com'] 
vlst,['Top', Quant',".','vip'] 
#2 
s2,['PyQt5’,'.',;com'] 
s3,['PyQts','.’] 
s4,["Top','Quant’,’."] 
#3 
s2+53,['PyQt5’,’.’,"com','PyQts','.’] 
s3*2,['PyQts’,’.’,'PyQts’,"."] 
加 号 (+) 是 列表 连接 运算 符 ， 乘 号 CO) 表示 重复 操作 。 
列表 操作 常用 函数 和 方法 如 下 。 
(1) 列表 操作 包含 以 下 函数 。 
e cmp(list1,list2): 比较 两 个 列表 的 元 素 。 
o len(list): 列表 元 素 个 数 。 
e max(list): 返回 列表 元 素 的 最 大 值 。 
e min(list): 返回 列表 元 素 的 最 小 值 。 
o list(seq): 将 元 组 转换 为 列表 。 
(2) 列表 操作 包含 以 下 方法 。 
e list.append(obj): 在 列表 末尾 添加 新 的 对 象 。 
e list.count(obj): 统计 某 个 元 素 在 列表 中 出 现 的 次 数 。 
e list.extend(seq): 在 列表 末尾 一 次 性 追加 另 一 个 序列 中 的 多 个 值 























(用 新 列表 扩展 原来 的 列表 )〉。 
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o list.index(obj): 从 列表 中 找 出 某 个 值 第 一 个 匹配 项 的 索引 位 置 。 

e list.insert(index,obj): 将 对 象 插 入 列表 中 。 

e list.pop(obj=list[-1]): 移 除 列 表 中 的 一 个 元 素 〈 默 认 是 最 后 一 个 元 
， 并 且 返 回访 元 素 的 值 。 

e list.remove(obj): 移 除 列表 中 某 个 值 的 第 一 个 匹配 项 。 

o list.reverse(): 反 回 列表 中 元 素 。 

o list.sort([func]): 对 原 列表 进行 排序 。 











2.5 Tuple〈 元 组 ) 


元 组 用 “( ) 标 识 ， 内 部 元 系 用 逗号 隔 开 ， 它 是 列表 数据 格式 的 简化 
版 本 ， 不 能 二 次 赋值 ， 类 似 于 只 读 列 表 。 


案例 2-5 元 组 操作 





案例 2-5 文 件 名 为 为 py205tuple.py， 保 存 路 径 为 
PyQt5/Chapter02/py205tuple.py， 主 要 介绍 元 组 的 基本 用 法 。 其 核心 代码 
如 下 : 

#1 

print(\n#1') 
zlst=('hello','PyQt5',".",,'com') 
vlst=('Top','Quant','.' vip’ 
print(‘zlst,',zlst) 
print(‘vlst,',vlst) 

#2 

print(\n#2') 
s2=zlst[1:];print('s2,',s2) 
s3=zlst[1:3];print('s3,',s3) 
s4=vlst[:3];print('s4,',s4) 
#3 

print(‘\n#3') 
print('s2+s3,',s2+s3) 
print('s3*2,',s3*2) 


对 应 的 输出 信息 如 下 : 
#1 
zlst,('hello','PyQt5','.','com') 
vlst,('Top', Quant',".','vip') 
#2 
s2,('PyQt5','.','com'’) 
s3,(‘PyQts','.') 
4,(‘Top','Quant’,’.’) 
#3 
s2+53,(‘PyQt5’,’.’,"com','PyQt5',".’) 
s3*2,(‘PyQts’,’.’,'PyQts',’.’) 


2.6 Dictionary (Hi) 


字典 用 “{ PENR, BRI Chey) 和 它 对 应 的 值 Cvalue) 组 成 ， 是 
除 列 表 以 外 ，Python 中 最 灵活 的 内 置 数据 结构 类 型 ， 类 似 于 其 他 语言 的 
k-v 数据 类 型 。 列 表 是 有 序 的 对 象 结合 ， 而 字典 是 无 序 的 对 象 集合 。 

Python 字典 是 另 一 种 可 变 容器 模型 ， 且 可 存储 任意 类 型 的 对 象 ， 如 
字符 串 、 数 字 、 元 组 等 其 他 容器 模型 。 

字典 由 键 和 对 应 的 值 成 对 组 成 ， 字 典 也 被 称 作 关 联 数 组 或 哈 希 表 。 
字典 中 的 元 素 是 通过 key 关 键 字 来 存 取 的 ， 而 不 是 通过 偏 移 存 取 的 。 


案例 2-6 字典 操作 


案例 2-6 文 件 名 为 py206dict.py， 保 存 路 径 为 
PyQt5/Chapter02/py206dict.py， 主 要 介绍 字典 的 基本 用 法 。 其 核心 代码 
如 下 : 

#1 

print(\n#1') 
zdict={} 
zdict['w1']='hello' 


zdict['w2']='ziwang.com' 




















print(‘zdict,',zdict) 

#2 

print(\n#2') 
vdict={'url1':"TopQuant.vip' 


,Url2:www.IopQuant.Vip' 


,url3':'ziwang.com’' } 
print(‘vdict,',vdict) 
#3 
print(‘\n#3') 
s2=zdict['w1'];print('s2,',s2) 
s3=vdict['url2'];print('s3,',s3) 
对 应 的 输出 信息 如 下 : 
#1 
zdict, {'w2': 'ziwang.com','w1': 'hello'} 
#2 
vdict, {'url3': 'ziwang.com’,'url2': 
'www. TopQuant.vip','url1':"TopQuant.vip'} 
#3 
52, hello 
s3,www. lopQuant.vip 
字典 内 置 函 数 和 方法 如 下 。 
(1) Python 字 上 典 包 含 以 下 内 置 函数 。 
e cmp(dict1,dict2): 比较 两 个 字典 元 素 。 
elen(dict): 计算 字典 元 素 的 个 数 ， 即 键 的 总 数 。 
e str(dict): 输出 本 印 的 字符 串 标 识 。 
e type(variable): 返回 输入 的 变量 类 型 ， 如 果 变 量 是 字典 ， 就 返回 
字典 类 型 。 
(2) Python 字典 包含 以 下 内 置 方法 。 
e radiansdict.clear(): 删除 字典 内 所 有 元 素 。 
e radiansdict.copy(): 返回 一 个 字典 的 浅 复制 。 
e radiansdict.fromkeys(): 创建 一 个 新 字典 ， 以 序列 seq 中 的 元 素 做 
典 的 键 ，val 为 字典 所 有 键 对 应 的 初始 值 。 





e radiansdict.get(key,default=None): 返回 指定 键 的 值 ， 如 果 值 不 在 
字典 中 ， 则 返回 default 值 。 

e radiansdict.has_key(key): 如 果 键 在 字典 中 ， 则 返回 true; 否则 返 
[4] false. 

e radiansdict.items(): 以 列表 形式 返回 可 过 历 的 ( 键 , 值 ) 元 组 数组 。 

e radiansdict.keys(): 以 列表 形式 返回 一 个 字典 中 所 有 的 键 。 

e radiansdict.setdefault(key,default=None): 和 getO 类 似 ， 但 如 果 键 已 
经 不 存在 于 字典 中 ， 则 将 添加 键 并 将 值 设 为 default。 

e radiansdict.update(dict2): 把 dict2 的 键 - 值 对 更 新 到 字典 中 。 

e radiansdict.values(): 以 列表 形式 返回 字典 中 所 有 的 值 。 


2.7 数据 类 型 


有 了 时候， 需要 对 数据 内 置 的 类 型 进行 转换 ， 只 要 将 数据 类 型 作为 函 
数 名 即 可 。 

以 下 几 个 内 置 函 数 可 以 执行 数据 类 型 之 间 的 转换 ， 这 些 函 数 返 回 一 
个 新 的 对 象 ， 表 示 转 换 的 值 。 

o int(x [,base]): 将 x 转换 为 一 个 整数 。 

o long(x [,base]): 将 x 转换 为 一 个 长 整数 。 

e float(x): 将 x 转换 为 一 个 浮 点 数 。 

e complex(real): 创建 一 个 复数 。 

o str(x): 将 对 象 x 转换 为 字符 串 。 

o repr(x): 将 对 象 x 转换 为 表达 式 字 符 串 。 

e eval(str): 用 来 计算 字符 串 中 有 效 的 Python 表达 式 ， 并 返回 一 个 对 


o tuple(s): 将 序列 s 转 换 为 一 个 元 组 。 

e list(s): 将 序列 s 转 换 为 一 个 列表 。 

o chr(x): 将 一 个 整数 转换 为 字符 。 

e unichr(x): 将 一 个 整数 转换 为 Unicode 字 符 。 
e ord(x): 将 一 个 字符 转换 为 它 的 整数 值 。 

o hex(x): 将 一 个 整数 转换 为 十 六 进 制 字符 串 。 
o oct(x): 将 一 个 整数 转换 为 八进制 字符 串 。 


2.8 控制 语 和 


Python 语 言 的 控制 语句 和 其 他 编程 语言 类 似 ， 常 用 的 有 if...else、 


while、for 语 句 。 
案例 2-7 控制 语句 


案例 2-7 文件 名 为 py207ctrlLpy， 保 存 路 径 为 
PyQt5/Chapter02/py207ctrl.py， 主 要 介绍 Python 常用 的 控制 语句 。 由 于 程 
序 代码 较 长 ， 我 们 分 组 进行 说 明 。 

第 1 组 代码 ， 说 明 if-else 语 人 句 : 

#1 
print(\n1,if') 
x,y,Z=10,20,5 
ifx>y: 
print('x>y') 
else: 
print('x<y’') 
对 应 的 输出 信息 如 下 : 
1, if 
x<y 
第 2 组 代码 ， 说 明 elif 语 句 : 
#2 
print(‘\n#2, elif’) 
x,y,Z=10,20,5 


ifx>y: 


print('x>y') 
elif x>z: 
print('x>z’') 
对 应 的 输出 信息 如 下 : 
#2,elif 
X>Z 
第 3 组 代码 ， 说 明 whbile 循 环 语句 : 
#3 
print(‘\n#3,while') 
x=3 
while x>0: 
print(x) 
x-=1 
对 应 的 输出 信息 如 下 : 
#3,while 
3 
2 
1 


第 4 组 代码 ， 说 明 for 循 环 语句 的 第 一 种 用 法 : 
#4 
print(‘\n#4,for') 
xlst=['1','b','xxx'] 
for x in xlst: 
print(x) 
对 应 的 输出 信息 如 下 : 
#4,for 


1 


b 
第 5 组 代码 ， 说 明 for 循 环 语句 的 第 二 种 用 法 : 
#5 
print(\n#5,for') 
for x in range(3): 
print(x) 
对 应 的 输出 信息 如 下 : 
#5,for 
0 
1 
2 





在 Python 控 制 语句 中 ， 需 要 注意 的 是 for 人 循环 语句 ， 其 采用 的 是 达 代 
模式 ， 与 传统 编程 语言 差异 较 大 ; 对 于 其 他 控制 语句 ， 用 法 都 差不多 。 








2.9 Bie X PŽ 





Python S SRA THY, RABE CRB Ae 7 eR E 
用 相同 的 一 段 程 序 。 将 常用 的 代码 块 定义 为 一 个 函数 ， 以 后 想 实 现 相同 
的 操作 时 ， 只 要 调用 函数 名 就 可 以 了 ， 而 不 需要 重复 输入 所 有 的 语句 。 





函数 的 定义 使 用 def 命 令 。 
案例 2-8 函数 定义 
案例 2-8 文件 名 为 py208fun.py， 保 存 路 径 为 


PyQt5/Chapter02/py208fun.py， 主 要 说 明 自 定义 函数 的 使 用 。 其 核心 代 
码 如 下 : 
def f01(a,b,c): 
print(‘a,b,c,',a,b,c) 
a2,b2,c2,=at+c,b*2,c*2 
return a2,b2,c2 
#1 
print(‘\n#1') 
x,y,Z=f01(1,2,3) 
print('x,y,Z,',X,y,Z) 
#2 
print(‘\n#2’') 
x,y,Z=f01(x,y,z) 
print('x,y,Z,',X,Y,Z) 


云 行 结 果 如 下 : 


#1 

a,b,c,1 2 3 

X,y,Z,4 46 

#2 

a,b,c,4 4 6 

x,y,Z,10 8 12 
在 以 上 代码 和 输出 信息 中 ， 需 要 注意 的 是 : 
ea、b、c 的 输出 信息 是 由 自 定 义 函 数 f01 实 现 的 。 
o 调用 f01 函 数 时 ， 变 量 x、y、z 既 是 输入 参数 ， 也 是 输出 变量 。 
e Python 函数 文 持 多 个 返回 数据 。 

















2.10 负数 partial 


典型 的 ， 函 数 在 执行 时 ， 要 带 上 所 有 必要 的 参数 进行 调用 。 然 而 ， 
有 时 参数 可 以 在 函数 被 调用 之 前 提前 获知 。 在 这 种 情况 下 ， 一 个 函数 有 
一 个 或 多 个 参数 预先 就 能 用 上 ， 以 便 函 数 能 用 更 少 的 参数 进行 调用 。 
在 使 用 partial 函 数 前 ， 首 先 需 要 导入 functools 模 块 。 


import functools 
案例 2-9 partial K ži íE H 


案例 2-9 文件 名 为 py209fun.py， 保 存 路 径 为 
PyQt5/Chapter02/py209fun.py， 主 要 说 明 partial 函 数 的 使 用 。 其 核心 代码 
如 下 : 

import functools 
def add(a,b): 

return a + b 
#1 
print(‘\n#1') 
rstl=add(4,2) 
print(‘add(4,2)="' ,rst1) 
plus3=functools.partial(add,3) 
plus5=functools.partial(add,5) 
#2 
print(\n#2') 
rst2=plus3(4) 


print(‘plus3(4)=" ,rst2) 

rst3=plus3(7) 

print(‘plus3(7)=" ,rst3) 

rst4=plus5(10) 

print(‘plus5(10)=" ,rst4) 

运行 结果 如 下 : 

#1 

add(4,2)=6 

#2 

plus3(4)=7 

plus3(7)=10 

plus5(10)=15 

一 个 函数 可 以 有 多 个 参数 ， 在 有 些 情况 下 有 的 参数 可 以 先 得 到 ， 而 
有 的 参数 需要 在 后 面 的 情景 中 才能 知道 ，Python 提 供 了 partial 函 数 用 于 
携 市 部 分 参数 生成 一 个 新 图 数 。 

plus3=functools.partial(add,3) 

把 参数 '3' 先 传 入 函数 add0 中 ， 生 成 一 个 新 的 函数 Plus30)。 

rst3=plus3(4) 

把 最 后 获得 的 参数 '7' 传 入 函数 plus30 中 ， 因 为 第 一 个 参数 '3' 已 经 先 
行 传 入 ， 所 以 最 后 的 结果 是 3+4=7。 

plus3(7)=10 

同 理 ， 把 最 后 获得 的 参数 '7' 传 入 函数 plus30 中 ， 最 后 获得 的 结果 是 
3+7=10。 

通过 以 上 例子 可 以 发 现 : 

o partial 函 数 定 义 了 一 个 匿名 函数 。 

o partial 并 不 会 市 来 程序 运行 效率 的 提高 ， 只 会 使 代码 更 简洁 。 





























2.11 lambda 表达 式 


lambda 的 一 般 形 式 是 在 关键 字 lambda 后 面 跟 一 个 或 多 个 参数 ， 之 后 
再 紧 跟 一 个 冒号 ， 接 下 来 是 一 个 表达 式 。lambda 是 一 个 表达 式 ， 而 不 是 
一 个 语句 ， 它 能 够 出 现在 Python 语法 不 允许 def 出 现 的 地 方 。 作 为 表达 
式 ，lambda 返 回 一 个 值 〈 即 一 个 新 的 函数 ) 。lambda 用 来 编写 简单 的 函 
数 ， 而 def 用 来 处 理 更 强大 的 任务 。 


案例 2-10 lambda K i> IR EÈ 


案例 2-10 文 件 名 为 py210fun.py， 保 存 路 径 为 
PyQt5/Chapter02/py210fun.py， 主 要 说 明 lambda 表 达 式 的 使 用 。 其 核心 
代码 如 下 : 

funl=lambda x,y : x + y 
print('fun1(2,3)=' ,fun1(2,3)) 
fun2=lambda x: x*2 
print('fun2(4)=' ,fun2(4) ) 
运行 结果 如 下 : 

fun1(2,3)=5 

fun2(4)=8 

从 上 面 代 码 可 以 看 出 ，lambda 表达 式 是 为 了 减少 单行 函数 的 定义 而 
存在 的 。lambda 的 使 用 大 量 简化 了 代码 ， 使 代码 简练 、 清 晰 。 


2.12 类 和 实例 





类 和 对 象 是 面 同 对 象 编程 的 两 个 主要 方面 。 类 创建 一 个 新 类 型 ， 而 
对 象 是 这 个 类 的 实例 ， 类 使 用 dlass 关 键 字 创建 。 类 的 域 和 方法 被 列 在 一 
个 缩 进 块 中 ， 一 般 函 数 也 可 以 被 叫 作 方 法 。 

(1) 类 的 变量 : 由 一 个 类 的 所 有 对 象 〈( 实 例 ) 共享 使 用 ， 只 有 一 
个 类 变量 的 拷贝 ， 所 以 当 某 个 对 象 对 类 的 变量 做 了 改动 时 ， 这 个 改动 会 
反映 到 其 他 所 有 的 实例 上 。 笔 者 的 理解 是 : 其 实 它 就 是 一 个 类 的 全 局 变 
量 ， 类 实例 化 后 的 对 象 都 可 以 调用 该 变量 。 

(2) 对 象 的 变量 : 由 类 的 每 个 对 象 /实例 拥有 ， 因 此 每 个 对 象 都 有 
自己 对 这 个 域 的 一 份 拷贝 ， 即 它们 不 是 共享 的 ， 在 同一 个 类 的 不 同 实例 
中 ， 虽 然 对 象 的 变量 有 相同 的 名 称 ， 但 是 它们 互 不 相关 。 笔 者 的 理解 
fe: 不 同 的 对 象 调用 该 变量 ， 其 值 改变 后 互 不 影响 。 

属于 类 级 别 的 变量 ， 在 使 用 时 一 定 要 带 上 类 型 名 称 ， 比 如 
MyClass.count; 属于 每 个 对 象 级 别 的 变量 ， 在 调用 时 一 定 要 融 上 self 表 
明 属 于 当前 对 象 ， 比 如 self.name。 


案例 2-11 类 和 实例 的 使 用 














案例 2-11 文 件 名 为 py211class.py， 保 存 路 径 为 
PyQt5/Chapter02/py211class.py， 主 要 介绍 类 和 实例 的 变量 。 其 核心 代码 
如 下 : 

class MyClass: 





count=0 


name='DefaultName' 


def __init__(self,name): 
self. name=name 
print( 类 的 变量 是 %sn 对 象 的 变量 是 %s 
MyClass.name,self.name) ) 
def setCount(self,count ): 
self.count=count 
def getCount(self): 


return self.count 


W W 


if name ==" main_": 
cls=MyClass(‘lisi') 
cls.setCount(10) 
print(‘count=%d' % cls.getCount()) 
运行 结果 如 下 : 
类 的 变量 是 DefaultName 
对 象 的 变量 是 lisi 
对 象 的 count: 10 


init 方法 属于 Python 语言 的 构造 函数 ， 一 个 类 只 能 有 一 个 


init 方法， 用 于 初始 化 类 及 其 变量 。 
通过 对 象 的 setCount()、getCount(0) 函 数 处 理 它 的 变量 。 


% 


2.13 类 的 属性 和 方 ; 





类 的 方法 : 在 类 的 内 部 可 以 使 用 def 关键 字 定 义 一 个 方法 。 与 一 般 
函数 不 同 ， 类 的 方法 必须 包含 参数 self， 且 为 第 一 个 参数 。 

类 的 私有 方法 : 在 类 的 内 部 使 用 ， 命 名 格式 为 __private_method。 
私有 方法 以 两 个 下 画 线 开头 ， 声 明 该 方法 为 私有 的 ， 不 能 在 类 的 外 部 调 
用 ， 只 能 在 类 的 内 部 调用 ， 比 如 self.__private_methods。 

类 的 私有 属性 : 在 类 的 内 部 使 用 ， 命 名 格式 为 ”private_attrs。 私 有 
属性 以 两 个 下 夯 线 开头 ， 声 明 该 属性 为 私有 的 ， 不 能 在 类 的 外 部 使 用 或 
直接 访问 ， 只 能 在 类 内 部 的 方法 中 使 用 ， 比 如 self. private_attrs。 


案例 2-12 类 的 属性 和 方法 的 使 用 


案例 212 文件 名 为 ” py212privateProperty.py， 保 存 路 径 为 
PyQt5/Chapter02/py212privateProperty.py， 主 要 介绍 类 的 属性 和 方法 的 
使 用 。 其 核心 代码 如 下 : 

class MyCounter: 
__secretCount=0 # 私有 变量 
publicCount=0 # 公共 变量 
def __ privateCountFun(self): 
print(' 这 是 私有 方法 ") 
self. secretCount +=1 


self.publicCount +=1 








#print (self.__secretCount) 


def publicCountFun(self): 


print( 这 是 公共 方法 ') 
self._ privateCountFun() 
if name ==" main _": 
counter=MyCounter() 
counter.publicCountFun() 
counter.publicCountFun() 
print (‘instance publicCount=%d' % counter.publicCount) 
print (‘Class publicCount=%d' % MyCounter.publicCount) 
行 结 果 如 下 : 
这 是 公共 方法 
这 是 私有 方法 
这 是 公共 方法 
这 是 私有 方法 


instance publicCount=2 


2 


Class publicCount=0 

从 上 面 的 代码 可 以 看 出 : 

e 可 以 在 类 的 内 部 调用 私有 方法 ， 不 能 在 类 的 外 部 调用 。 
e 可 以 在 类 的 内 部 访问 私有 属性 ， 不 能 在 类 的 外 部 访问 。 
o 对 象 属性 类 型 的 声明 。 

Python 的 一 大 特色 就 是 无 须 声明 类 型 变量 ， 它 会 自动 判断 。 
注意 


以 下 调用 方法 是 错误 的 ， 仅 供 学 习 语 法 使 用 ， 方 便 理 解 语法 ， 不 要 








在 实际 环境 中 使 用 。 
读者 可 以 尝试 使 用 如 下 方法 调用 类 的 私有 方法 和 私有 属性 ， 程 序 会 
SUH RFS o 
if name ==" main _": 


counter=MyCounter() 


# 报错 ， 实 例 不 能 访问 私有 变量 
print (counter.__secretCount) 
# 报错 ， 实 例 不 能 访问 私有 方法 


counter.__ privateCountFun() 





2.14 类 的 动态 属 ' 


如 果 不 希 望 类 的 某 属 性 被 悄悄 地 访问 、 赋 值 或 修改 ， 希 望 在 被 访 
问 、 赋 值 或 修改 时 能 得 到 一 些 通 知 ， 那 么 可 以 使 用 函数 property0J。 函 数 
原型 是 : 
property([fget[,fset[,fdel[,doc]]]]) 
它 返 回 新 式 类 《继承 了 object 的 类 ) 的 一 个 属性 ， 其 中 fget 是 属性 被 
访问 时 执行 的 方法 ，fset 是 属性 被 赋值 时 执行 的 方法 ，fqdel 是 属性 被 删除 
时 执行 的 方法 。 


案例 2-13 类 的 动态 属性 操作 


下 面 代码 定义 了 一 个 MyClass 类 ， 该 类 必须 继承 自 object 类 ， 它 有 一 
个 私有 变量 _param。 

方法 一 : 使 用 类 的 属性 。 

案例 2-13 文件 名 为 py213property01.py， 保 存 路 径 为 
PyQt5/Chapter02/py 213property01.py， 主 要 介绍 使 用 类 的 属性 访问 类 的 
私有 变量 。 其 核心 代码 如 下 : 

class MyClass(object): 
def __ init__(self): 


self. param=None 





def getParam(self): 
print( "get param: %s" % self._ param) 
return self. param 


def setParam(self,value): 


print( "set param: %s" % self._param ) 
self._ param=value 

def delParam(self): 
print( "del param: %s" % self._ param) 
del self._ param 


param=property(getParam,setParam,delParam) 


I TT 


if name ==" main _": 
cls=MyClass() 
cls.param=10 
print("current param : %s " % cls.param ) 
del cls.param 
运行 结果 如 下 : 
set param: None 
get param: 10 
current param : 10 
del param: 10 
在 访问 对 象 属性 param 时 ， 对 应 执行 了 property(getx,setx,delx) ”所 指 
定 的 方法 而 做 了 一 些 额 外 的 事情 。 
方法 二 : 使 用 @property 访 问 类 的 属性 。 
同方 法 一 ， 首 先 定义 了 一 个 MyClass 类 ， 该 类 必须 继承 自 object 交 ， 
它 有 一 个 私有 变量 _param。@property 可 以 将 Python 定 义 的 函数 “ 当 
作 ” 属 性 访问 ， 从 而 提供 更 加 友好 的 访问 方式 ， 但 是 有 时 候 settergetter 也 
是 需要 的 。 
案例 2-13 文件 名 为 py213property02.py， 保 存 路 径 为 
PyQt5/Chapter02/py213 property02.py。 其 核心 代码 如 下 : 
class MyClass(object): 
def _ init__(self): 





self._ param=None 
(@property 
def param(self): 
print( "get param: %s" % self._ param) 
return self. param 
(@param.setter 
def param(self, value): 
print( "set param: %s" % self._param ) 
self. param=value 
@param.deleter 
def param(self): 
print( "del param: %s" % self._ param) 
del self._ param 
if name ==" main _": 
cls=MyClass() 
cls.param=10 
print("current param : %s " % cls.param ) 
del cls.param 
运行 结果 如 下 : 
set param: None 
get param: 10 
current param : 10 
del param: 10 
方法 二 的 效果 同方 法 一 ， 但 是 方法 二 更 加 灵活 、 简 单 ， 在 开发 中 经 
常 使 用 。 


£2333 Ot Designer} 


制作 程序 UI 界面 ， 一 般 可 以 通过 UI 制作 工具 和 纯 代 码 编写 两 种 方式 
来 实现 。 在 PyQt 5 中 ， 也 可 以 采用 这 两 种 方式 。 这 一 章 主 要 讲解 通过 Qt 
Designer 工 具 来 制作 UI 界 面 。 


y 


3.1 Ot Designer H IE 


Qt _ Designer， 即 Qt 设计 师 ， 是 一 个 强大 、 灵 活 的 可 视 化 GUI 设计 工 
有 具 ， 可 以 帮助 我 们 加 快 开发 PyQt 程 序 的 速度 。Qt Designer 是 专门 用 来 制 
作 PyQt 程 序 中 UI 界面 的 工具 ， 它 生成 的 UI 界面 是 一 个 后 级 为 .ui 的 文 
件 。 该 文件 使 用 起 来 非常 简单 ， 可 以 通过 命令 将 .ui 文件 转换 成 .py 格式 
的 文件 ， 并 被 其 他 Python 文 件 引 用 ; 也 可 以 通过 Eric ”6 进行 手工 转换 。 
本 章 以 命令 的 方式 为 主 ， 手 工 的 方式 为 辅 ， 但 是 原理 和 结果 是 一 样 的 ， 
读者 可 以 根据 自己 的 偏好 进行 选择 。 示 例如 图 3-1 所 示 。 











a |firstMainWin py 
eee ul 
图 3-1 


Qt Designer 符 合 MVC 《模型 一 视图 一 控制 器 ) 设计 模式 ， 做 到 了 显 
示 和 业务 逻辑 的 分 离 。 

Qt Designer 具 有 以 下 优点 。 

e 使 用 简单 ， 通 过 拖 电 和 点 击 就 可 以 完成 复杂 的 界面 设计 ， 而 且 还 
可 以 随时 预览 耕 看 效果 图 。 

o 转换 Python 文件 方便 。Qt Designer 可 以 将 设计 好 的 用 户 界面 保存 
为 .ui 文件 ， 其 实 是 XML 格式 的 文本 文件 。 为 了 在 PyQt 中 使 用 .ui 文 
件 ， 可 以 通过 ”pyuic5 命 令 将 .ui 文件 转换 为 .py 文件 件 ， 然 后 将 .py 文件 引 
入 到 目 定 义 的 Python 代码 中 。 

Qt Designer 默认 安装 在 %/python3.*/site-pages/pyqt5-tools 目录 下 ， 





在 笔者 的 机 器 上 Qt Designer 的 安装 路 径 是 
E:\installed_software\python35\Lib\site-packages\pyqt5-tools 。 
Qt Designer 的 启动 文件 为 designer.exe， 如 图 3-2 所 示 。 





[asa > Phos (E) > installed_software » python35 » Lib » site-packages » pyqt5-tools 
build_id 
job_id 
& assistant.exe 
canbusutilexe 
3 designer.exe , 778/2 16:10 7 用 程序 
dumpcpp.exe 


dumpdoc.exe 


> = = P =- 


jconvert.exe ， 2 1 及 程序 
J linguist.exe 
lrelease.exe 
lupdate.exe 
pixeltool.exe 
qcollectiongenerator.exe 
qdbus.exe 
qdbuscpp2xml.exe 
2 qdbusviewer.exe 


qdbusxml2cpp.exe 


>. =- = É = a =- =- _ F 


qdoc.exe 





qglitt.exe 





图 3-2 


3.1.1 新 建 主 窗口 


在 Qt Designer 的 安装 路 径 下 双击 designer.exe 文 件 ， 打 开 PyQt 5 的 Qt 
Designer， 会 自动 弹出 “新 建 窗 体 ”对 话 框 ， 如 图 3-3 所 示 。 在 模板 选项 
中 ， 最 常用 的 就 是 Widget (通用 窗口 ) 和 Main Window〔 主 窗口 )。 在 
PyQt 5 中 Widget 被 分 离 出 来 ， 用 来 苦 代 Dialog， 并 将 Widget 放 入 了 
QtWidget 模 块 库 中 。 


a) 
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图 3-3 


模板 选择 “Main Window”， 创 建 一 个 主 窗口 ， 保 存 并 命名 为 
firstMainWin.u， 如 图 3-4 所 示 ， 主 窗口 默认 添加 了 荣 单 栏 、 工 具 栏 和 状 
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图 3-4 


3.1.2 窗口 又 域 介 绍 


在 图 3-4 中 标注 了 窗口 的 主要 区 域 ， 区 域 1 是 Widget Box (工具 
箱 ) ， 如 图 3-5 所 示 ， 其 中 提供 了 很 多 控件 ， 每 个 控件 都 有 自己 的 名 
称 ， 提 供 不 同 的 功能 ， 比 如 常用 的 按钮 、 单 选 钮 、 文 本 框 等 ， 可 以 直接 
拖 放 到 主 窗口 中 。 在 菜单 栏 中 选择 “ 窗 体 ” “预览 "， 或 者 按 “Ctrl+R” 快 
捷 键 ， 束 可 以 看 到 窗口 的 预览 效果 了 。 
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图 3-5 


可 以 从 Buttons 栏 拖 忠 一 个 按钮 到 主 窗口 (区 域 2) 中 ， 如 图 3-6 所 





图 3-6 


在 对 象 查看 器 (区 域 3) 中 ， 可 以 查看 主 窗口 中 放置 的 对 象 列表 ， 
如 图 3-7 所 示 。 





a MainWindow QMainWindow 


centralwidget QWidget 

pushButton læ] QPushButton 
menubar QMenuBar 
statusbar QStatusBar 





图 3-7 





区 域 4 是 Qt ”Designer 的 属性 编辑 器 ， 其 中 提供 了 对 窗口 、 控 件 、 布 
局 的 属性 编辑 功能 ， 如 图 3-8 所 示 。 


属性 编辑 器 


IF ilter 





pushButton : QPushButton 


pushButton 


enabled 
4 geometry [(230, 150), 93 x 28] 
230 
150 
93 
28 
» sizePolicy [Minimum, Fixed, 0, 0] 
>» minimumSize 0x0 
>» maximumSize 16777215 x 16777215 
ò sizeIncrement 0x0 
> baseSize 0x0 
palette 继承 
> font A [SimSun, 9] 





图 3-8 


e objectName， 控 件 对 象 名 称 。 

e geometry， 相 对 坐标 系 。 

o sizePolicy， 控 件 大 小 策略 。 

e minimumSize， 最 小 宽度 、 高 度 。 

e maximumSize， 最 大 宽度 、 高 度 。 如 果 想 让 窗口 或 控件 的 大 小 固 








定 ， 则 可 以 将 minimumSize 和 maximumSize 这 两 个 属性 设置 成 一 样 的 数 
值 。 

e font， 字 体 。 

è cursor, JEER- 

e windowTitle， 窗 口 标题 。 

e windowsIcon/icon， 窗 口 图 标 /控件 图 标 。 

eè iconSize， 图 标 大 小 。 

e toolTip， 提 示 信 息 。 

o statusTip， 任 务 栏 提示 信息 。 

o text， 控 件 文本 。 

o shortcut, WIEHE. 

XS 1a sA E as A ot bas, APE S/S 
编辑 器 中 ， 可 以 为 控件 添加 自 定 义 的 信号 和 槽 函数 ， 编 辑 控件 的 信号 和 
槽 函数 ， 如 图 3-9 所 示 。 








信号 / 槽 编辑 器 Bx 
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发 送 者 言 号 接收 者 = 
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图 3-9 





在 资源 浏览 器 中 ， 可 以 为 控件 添加 图 片 ， 比 如 Label、Button 的 背景 
图 片 ， 如 图 3-10 所 示 。 
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图 3-10 


3.1.3 查看 UI 文件 


采用 Qt Designer 工具 设计 的 界面 文件 默认 为 .ui 文件 ， 描 述 了 窗口 
中 控件 的 属性 列表 和 布局 显示 。.ui 文件 里 面包 含 的 内 容 是 按照 
XML (可 扩展 标记 语言 ) 格式 处 理 的 。 

首先 ， 使 用 Qt Designer 工 具 打 开 PyQt5/Chapter03/firstMainWin.ui 文 
件 ， 可 以 看 到 在 主 窗 口中 放置 了 一 个 按钮 ， 其 objectName 
为 "pushbutton”， 它 在 窗口 中 的 坐标 为 (490,110)， 按 钮 的 宽度 为 93px， 
高 度 为 28px， 如 图 3-11 所 示 。 





pushButton : QPushButton 
属性 a 


QObject 
QWidget 
enabled yj 
[(490, 110), 93 x 28] 





[Minimum, Fixed, 0, 0} 
0x0 
16777215 x 16777215 




















图 3-11 


然后 ， 使 用 文本 编辑 器 打开 firstMainWin.ui 文 件 ， 显 示 的 内 容 如 图 
3-12 所 示 。 


f=) firstMainWin. ui 


<?xml version="1.0" encoding="UTF-8"?> 
<ui version="4.0"> 
<class>MainWindow</class> 
<widget class="QMainWindow" name="MainWindow"> 
<property name="geometry"> 
<rect> 
<x>0</x> 
<y>0</y> 
<width>726</width> 
<height>592</height> 
</rect> 
</property> 
<property name="windowTitle"> 
<string>MainWindow</string> 
</property> 


OONAN Whe 


pa pa pa pd pd d p opd a a 
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<rect> 
<x>490</x> 
<y>110</y> 
<width>93</width> 
<height>28</height> 
</rect> 
</property> 
<property name="text"> 
<string> 按 钮 </string> 
</property> 
</widget> 
</widget> 
<widget class="QMenuBar" name="menubar"> 
<property name="geometry"> 
<rect> 
<x>0</x> 
<y>0</y> 
<width>726</width> 
<height>26</height> 
</rect> 
</property> 
</widget> 
<widget class="QStatusBar"” name="statusbar"/> 
</widget> 
<resources/> 
<connections/> 
</ui> 
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图 3-12 


从 图 3-12 可 以 看 出 ， 按 钮 的 设置 参数 与 使 用 Qt Designer 打 开 .ui 文 件 





时 显示 的 信息 是 一 致 的 。 有 了 Qt Designer， 开 发 者 就 能 够 更 快 地 开发 设 
计 出 程序 界面 ， 避 免 了 用 纯 代 码 来 编写 的 烦琐 ， 从 而 不 必 担 心底 层 的 代 
人 码 实现 。 


3.1.4 将 .ui 文件 转换 为 .py 文件 


使 用 Qt Designer 设 计 的 用 户 界 面 默认 保存 为 .ui 文件 ， 其 内 容 结构 类 
似 于 XML， 但 这 种 文件 并 不 是 我 们 想 要 的 ， 我 们 想 要 的 是 .py 文件 ， 所 
以 还 需要 使 用 其 他 方法 将 .ui 文件 转换 为 .py 文件 。 本 书 提供 了 3 种 方法 。 

1. 通 过 Eric 6 把 .ui 文件 转换 为 .py 文件 
最 简单 的 方法 是 通过 Eric 6 手工 编译 .ui 文件 ， 只 需要 单 击 鼠标 就 能 
成 


alt 


如 图 3-13 所 示 ， 打 开 Eric 6 编辑 器 ， 切 换 到 “ 窗 体 ”选项 卡 ， 然 后 选 
中 firstMainWin.ui 文 件 ， 单 击 鼠 标 右键 ， 选 择 “ 编 译 窗 体 ” 就 可 以 了 。 

注意 

如 果 找 不 到 ”firstMainWin.ui 文件 ， 则 可 以 通过 单 击 鼠标 右键 ， 选 
择 “ 添 加 窗 体 ? 或 “添加 窗 体 文 件 夹 ” 来 手动 添加 firstMainWin.ui 文件 ， 这 
里 添加 的 是 PyQt5-codes 文 件 夹 。 








文件 (F) ”编辑 (E) ”视图 (V) ”开始 (S) ”调试 (D) ”单元 测试 (U) 多重 项 E 
9 So O Ano D | 


v BY PyQt5-codes 
v BR chapter03 
> Ø mainin 
> F testCase 
® Main#in0l. ui 
® Main¥in02. ui 
® Main¥inSignalSlogf1, ui 


® layout#in. ui 
A Chapter08 
E Chapter09 
E Chapter10 
E Chapterll 


E 
T 
m 
E 
ba 
H 
IR 
TE 
ani 
KE 
4 
Si 
F 
: 
ie 


| 


= 
ta 


E 文件 浏览 器 





符号 


图 3-13 


上 述 操作 完成 之 后 ， 切 换 回 “ 源 代 码 ? 选 项 卡 ， 如 图 3-14 所 示 ， 可 以 
看 到 生成 了 一 个 Ui_firstMainWin.py 文 件 ， 这 就 是 编译 后 的 结果 。 
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图 3-14 


双击  Ui_firstMainWin.py XF, Aa Hi KE ~ “运行 脚 
本 ?或 者 按 F2 键 ， 运 行 结果 如 图 3-15 所 示 。 与 firstMainWin.ui 所 呈现 的 
结果 一 致 ， 这 说 明成 功 地 把 .ui 文件 转换 成 了 .py 文件 。 
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图 3-15 


2. 通 过 命令 行 把 .ui 文件 转换 为 .py 文件 

PyQt 5 安装 成 功 后 ，pyuic5 命 令 默 认 安 装 在 %/python3x/Scripts 目 录 
下 ， 在 笔者 的 机 器 上 pyuic5 的 安装 路 径 是 
E:\installed_software\python35\Scripts 。 

注意 

如 果 输 入 pyuic5 命 令 没 有 得 到 正确 提示 ， 而 是 提示 “pyuic5 不 是 内 部 
命令 或 外 部 命令 ， 也 不 是 可 运行 的 程序 或 批 处 理 文件 >， 则 是 由 于 
Python 3.* 环 境 配 置 出 错 导 致 的 ， 请 参考 1.2 刘 “PyQt 5 环境 搭建 ?配置 正 








确 的 Python 环境 。 
要 想 将 firstMainWin.ui 转 换 成 .py 文件 ， 通 过 PyQt 5 提供 的 命令 行 工 
具 pyuic5 可 以 轻松 实现 。 这 里 一 般 将 ”UI 单独 存 成 一 个 文件 ， 便 于 更 
新 。 输 入 以 下 命令 把 UI 文 件 转换 成 Python 文件 。 
pyuic5-o firstMainWin.py firstMainWin.ui 
如 果 转 换 成 功 ， 则 结果 如 图 3-16 和 图 3-17 所 示 。 


E:\quant\PyQtS\ChapterQ3>pyuicS -o firstMainWin.py firstMainWin.ui 


E:\quant\PyQ@t5S\Chapter03>dir 
Be E 中 的 卷 是 新 加 卷 
疮 的 序列 号 是 C668-5BF6 


E:\quant\PyatS\Chapter03 Hf 


2017/05/20 
2017/05/20 > 
2017/05/20 1,486 firstMainWin. py 
2017/05/20 : 1,039 firstMainWin.ui 
个 文人 2,525 字 节 
444,841,472 可 用 字 节 





| firstMainWin.py PY 文件 
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图 3-17 
提示 
关于 pyuic5 命 令 的 详细 介绍 ， 可 以 参考 官方 网 站 : 


http://pyqt.sourceforge.net/Docs/PyQt5/designer.html?highlight=signal. 
3. 通 过 Python 脚本 把 .ui 文件 转换 为 .py 文件 


有 些 读 者 可 能 对 命令 行 的 使 用 不 熟悉 或 者 不 太 喜 欢 ， 所 以 本 书 提 供 
了 Python 脚本 来 完成 转换 ， 这 个 脚本 本 质 上 是 用 Python 代码 把 上 述 操作 
封装 起 来 。 本 例文 件 名 为 PyQt5/Chapter03/tool.py， 其 完整 代码 如 下 : 


import os 
import os.path 


# UI 文件 所 在 的 路 径 
oy/ 


+ 列 出 目录 下 的 所 有 UI 文件 
def listUiFile(): 
list = [] 
files = os.listdir (dir) 
for filename in files: 
forint ( dir + os.sep + £ ) 
#print (filename) 
if os.path.splitext (filename) [1] == '.ui': 


list.append (filename) 


return list 


# 把 扩展 名 为 .ui 的 文件 改 成 扩展 名 为 .py 的 文件 
def transPyFile (filename): 
return os.path.splitext (filename) [0] + '.py' 


# 调用 系统 命令 把 UI 文件 转换 成 Python 文件 
def runMain(): 
list = listUiFile() 
for uifile in list. = 
pyfile = transPyFile(uifile) 
cmd = 'pyuic5 -o {pyfile} 
{uifile}'.format (pyfile=pyfile, uifile=uifile) 
#print (cmd) 


os.system(cmd) 


HEHEHE 程序 的 主 入 口 
it Mame == Man "h 


runMain () 


只 要 把 tool.py 放 在 需要 转换 界面 文件 的 目录 下 ， 双 击 tool.py 束 可 以 
直接 运行 。 就 是 这 么 简单 ， 其 执行 效果 和 直接 执行 转换 命令 是 一 样 的 。 


使 用 Qt Designer 制 作 的 图 形 界 面 如 图 3-18 所 示 。 界 面 文件 为 


firstMainWin.ui. 


MainWindow - firstMainWin.ui 
在 这 里 输入 





图 3-18 


ells 


注意 

通过 本 市 内 容 ， 我 们 得 到 了 两 个 文件 firstMainWin.py 和 和 
Ui_firstMainWin.py， 这 两 个 文件 只 是 名 字 有 些 不 同 ， 内 容 是 一 样 的 。 接 
下 来 将 重点 使 用 firstMainWin.py 文 件 进行 分 析 。 


3.1.5 界面 与 逻辑 分 离 


我 们 通过 之 前 的 内 容 学 会 了 如 何 制作 .ui 文件 ， 以 及 如 何 把 .ui 文件 转 
换 成 .py 文件 。 值 得 注意 的 是 ， 由 于 这 里 的 .py 文件 是 由 .ui 文件 编译 而 来 
的 ， 因 此 当 .py 文 件 发 生变 化 时 ， 对 应 的 .py 文件 也 会 发 生变 化 。 我 们 把 
这 种 由 .ui 文件 编译 而 来 的 .py 文件 称 为 界面 文件 。 由 于 界面 文件 每 次 纺 
译 时 都 会 初始 化 ， 所 以 需要 新 建 一 个 .py 文件 调用 界面 文件 ， 这 个 新 建 
的 .py 文件 被 称 为 逻辑 文件 ， 也 可 以 称 为 业务 文件 。 界 面 文件 和 人 逻辑 文 
件 是 两 个 相对 独立 的 文件 ， 通 过 上 述 方法 就 实现 了 界面 与 逻辑 的 分 离 
《也 就 是 我 们 之 前 所 说 的 “显示 和 业务 逻辑 的 分 离 ”>) 。 

实现 界面 与 逻辑 的 分 离 方 法 很 简单 ， 只 需要 新 建 一 个 
CallFirstMainWin.py 文 件 ， 并 继承 界面 文件 的 主 窗口 类 即 可 。 其 完整 代 
人 码 如 下 : 

import sys 

from PyQt5.QtWidgets import QApplication ,QMainWindow 
from firstMainWin import * 

class MyMainWindow(QMainWindow,Ui_MainWindow): 





def __init__(self,parent=None): 
super(MyMainWindow,self).___init__(parent) 
self.setup Ui(self) 
if name ==" main _": 
app=QApplication(sys.argv) 
myWin=MyMainWindow() 
myWin.show() 
sys.exit(app.exec_()) 
在 上 面 的 代码 中 实现 了 业务 逻辑 ， 代 码 结构 也 清晰 很 多 。 如 果 以 后 
想 要 更 新 界面 ， 只 需要 对 .ui 文件 进行 更 新 ， 然 后 再 编译 成 对 应 的 .py 文 
件 即 可 ; 而 逻辑 文件 则 视 情 况 做 一 些 调整 ， 一 般 情 况 下 不 需要 调整 太 
多 。 


PyQt 文 持 界 面 与 逻辑 的 分 离 ， 这 对 于 新 手 来 说 无 疑 是 最 大 的 福音 。 
当然 ， 要 做 出 华丽 的 界面 还 是 要 学 一 些 代 码 的 ，Qt Designer 提 供 了 一 些 
解决 方法 。 男 外 ， 也 可 以 通过 Qt Designer 生 成 的 代码 来 学 习 一 些 窗口 控 
件 的 用 法 。 





在 3.1 节 中 我 们 只 介绍 了 一 个 按钮 控件 ， 如 果 需 要 更 多 的 控件 ， 则 
可 以 从 左 侧 的 Widget Box 工具 箱 ) 中 进行 拖 忠 。 本 市 重点 介绍 对 这 些 
控件 的 布局 。 

Qt Designer 提 供 了 4 种 窗口 布局 方式 ， 分 别 是 : Vertical Layout (Œ 
直 布 局 ) ~ Horizontal Layout (水 平 布 局 ) ~ Grid Layout〈 栅 格 布局 ) 
和 Form Layout (WAM) 。 它 们 位 于 Qt Designer 主 窗口 左 侧 区 域 的 
Widget Box 〈 工 具 箱 ) 里 的 Layouts (布局 ) 栏 中 ， 如 图 3-19 所 示 。 
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图 3-19 


o 垂直 布局 : 控件 默认 按照 从 上 到 下 的 顺序 进行 纵 回 添加 。 

e 水 平 布局 : 控件 默认 按照 从 左 到 右 的 顺序 进行 横 回 添加 。 

e 栅 格 布局 : 将 窗口 控件 放 入 一 个 网 格 之 中 ， 然 后 将 它们 合理 地 划 
ay MA FAT Crow) 和 列 〈column) ， 并 把 其 中 的 每 个 窗口 控件 放置 在 
合适 的 单元 〈cell) 中 ， 这 里 的 单元 即 是 指 由 行 和 列 交 叉 所 划分 出 来 的 
amj 








e ”表单 布局 : 控件 以 两 列 的 形式 布局 在 表单 中 ， 其 中 左 列 包含 标 
签 ， 右 列 包 含 输入 控件 。 

一 般 进 行 布局 有 两 种 方式 : 一 是 通过 布局 管理 器 进行 布局 ， 二 是 通 
过 容器 控件 进行 布局 。 








3.2.1 司 管 理 器 布 后 


以 水 平 布局 为 例 ， 打 开 Qt Designer， 新 建 一 个 QWidget 控 件 ， 然 后 
在 其 中 放 入 两 个 子 控件 : 一 个 文本 框 (ineEdit〉 和 一 个 按钮 
(pushButton) 。 选 中 这 两 个 控件 ， 然 后 单 击 鼠 标 右键 ， 在 弹出 的 快捷 
沫 单 中 选择 “布局 ”的 子 沫 单 承 可 以 指定 该 控件 的 布局 方式 了 ， 此 处 选 
择 “ 水 平 布 局 ”， 如 图 3-20 所 示 。 
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图 3-20 


将 .ui 文件 转换 成 .py 文件 后 ， 可 以 看 到 如 下 内 容 。 本 例文 件 名 为 
PyQt5/Chapter03/MainWin01.py。 
from PyQt5 import QtCore,QtGui, QtWidgets 
class Ui_Form(object): 
def setupUi(self,Form): 


Form.setObjectName("Form") 


Form.resize(511,443) 
self.widget=QtWidgets.QWidget(Form) 
self. widget.setGeometry(QtCore.QRect(50,40,273,30)) 
self.widget.setObjectName("widget") 
self. horizontalLayout=QtWidgets.QHBoxLayout(self.widget) 
self.horizontalLayout.setContentsMargins(0,0,0,0) 
self.horizontalLayout.setObjectName("horizontalLayout") 
self.lineEdit_2=QtWidgets.QLineEdit(self. widget) 
self.lineEdit_2.setObjectName("lineEdit_2") 
self.horizontalLayout.addWidget(self.lineEdit_2) 
self.pushButton_2=QtWidgets.QPushButton(self. widget) 
self.pushButton_2.setObjectName("pushButton_2") 
self.horizontalLayout.addWidget(self.pushButton_2) 
self.retranslateUi(Form) 
QtCore.QMetaObject.connectSlotsByName(Form) 
def retranslateUi(self,Form): 
_translate=QtCore.QCoreApplication.translate 
Form.setWindowTitle(_translate("Form","Form")) 
self.pushButton_2.setText(_translate("Form"," fff 7E")) 
可 以 看 到 ， 子 控件 QpushButton〈 按 钮 ) 和 QlineEdit〈( 文 本 框 ) 在 
构建 的 时 候 指 定 的 父 控件 对 象 就 是 QWidget， 布 局 对 象 QHBoxLayout 
站 定 的 父 控件 对 象 也 是 QWidget。 这 与 在 Qt Designer 的 对 象 查 看 器 中 看 
到 的 对 象 依赖 关系 是 一 样 的 ， 如 图 3-21 所 示 。 
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图 3-21 


注意 

如 果 是 从 工具 箱 中 拖 放 布局 控件 的 ， 那 么 其 属性 中 的 *Margin(* 是 
通配符 ， 可 以 匹配 一 个 或 多 个 字符 ) 默认 都 是 0。 

我 们 新 建 一 个 MainWindow， 以 同样 的 方式 进行 水 平 布 局 、 垂 直 布 
局 、 网 格 布局 和 表单 布局 ， 并 对 其 中 的 一 些 控件 进行 简单 的 重 命名 操 
作 ， 效 果 如 图 3-22 所 示 。 本 例文 件 名 为 PyQt5/Chapter03/layoutWin.ui。 








© MainWindow - layoutWin.ui 
在 这 里 输入 


姓名 


姓名 





图 3-22 


注意 

GridLayout 中 的 “计算 ”按钮 默认 占据 一 个 方 格 ， 对 其 进行 拉 伸 就 可 
以 占据 3 个 方 格 。 

布局 之 后 ， 需 要 对 层次 有 所 了 解 。 在 程序 设计 中 ， 一 般 用 父子 关系 
来 表示 层次 ， 就 像 在 Python 中 规定 代码 缩 进 量 代 表 不 同 层次 一 样 ， 如 图 
3-23 所 示 。 
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图 3-23 


在 对 象 查看 器 中 ， 我 们 可 以 方便 地 看 出 窗口 (MainWindow) -~ 布 
局 (Layout) ”~ 控件 〈 这 里 是 pushButton 按 钮 、QLabel 标 签 ) 的 层次 关 
系 。 窗 口 一 般 作 为 顶层 显示 ， 然 后 将 控件 按照 我 们 所 要 求 的 布局 方式 进 
行 排列 。 











所 谓 容器 控件 ， 就 是 指 能 够 容纳 子 控件 的 控件 。 使 用 容器 控件 ， 目 
的 是 将 容器 控件 中 的 控件 归 为 一 类 ， 以 有 别 于 其 他 控件 。 当 然 ， 容 器 控 
件 也 可 以 对 其 子 控件 进行 布局 ， 只 不 过 没有 布局 管理 器 常用 。 下 面 对 其 
进行 简单 介绍 。 


同样 以 水 平 布局 为 例 ， 新 建 一 个 MainWindow， 从 左 侧 容器 
(Containers) 导航 栏 拖 入 一 个 Form 控 件 ， 然 后 在 Form 控 件 中 放 入 
Label、LineEdit、Button 控 件 ， 并 对 其 进行 重 命 名， 如 图 3-24 所 示 。 
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图 3-24 


然后 选中 Form 控件 ， 单 击 鼠 标 右键 ， 选 择 “ 布 局 ”- “水 平 布局 ”， 
结果 如 图 3-25 所 示 。 





© MainWindow - ContainersWin.ui Objed Clase 

pe Y MainWindow QMainWindow 

v &%® centralwidget |] QWidget 
v Ii frame 国 QFrame 


























. C] n label ® QLabel 
n 姓名 确定 ra lineEdit æ QLineEdit 
. . a pus...ton læ] QPushButton 
menubar QMenuBar 
图 3-25 
本 例文 件 名 为 PyQt5/Chapter03/ContainersWin.ui。 将 


ContainersWin.ui 编译 为 ContainersWin.py， 代 码 如 下 : 
#-*- coding: utf-8-* 


from PyQt5 import QtCore,QtGui,QtWidgets 
class Ui_MainWindow(object): 
def setupUi(self, MainWindow): 

MainWindow.setObjectName("MainWindow") 
MainWindow.resize(800,600) 
self.centralwidget=QtWidgets.QWidget(MainWindow) 
self.centralwidget.setObjectName("centralwidget") 
self. frame=QtWidgets.QFrame(self.centralwidget) 
self.frame.setGeometry(QtCore.QRect(70,40,264,43)) 
self.frame.setFrameShape(QtWidgets.QFrame.StyledPanel) 
self.frame.setFrameShadow(QtWidgets.QFrame.Raised) 
self.frame.setObjectName("frame") 
self. horizontalLayout=QtWidgets.QHBoxLayout(self.frame) 
self.horizontalLayout.setObjectName("horizontalLayout") 
self.label=QtWidgets.QLabel(self.frame) 
self.label.setObjectName("label") 
self.horizontalLayout.addWidget(self.label) 
self.lineEdit=QtWidgets.QLineEdit(self.frame) 
self.lineEdit.setObjectName("lineEdit") 
self.horizontalLayout.addWidget(self.lineEdit) 
self.pushButton=QtWidgets.QPushButton(self.frame) 
self.pushButton.setObjectName("pushButton") 
self.horizontalLayout.addWidget(self.pushButton) 
MainWindow.setCentralWidget(self.centralwidget) 
self. menubar=QtWidgets.QMenuBar(MainWindow) 
self.menubar.setGeometry(QtCore.QRect(0,0,800,23)) 


self.menubar.setObjectName("menubar") 


MainWindow.setMenuBar(self.menubar) 
self.statusbar=QtWidgets.QStatusBar(MainWindow) 
self.statusbar.setObjectName("statusbar") 
MainWindow.setStatusBar(self.statusbar) 
self.retranslateUi(MainWindow) 
QtCore.QMetaObject.connectSlotsByName(MainWindow) 
def retranslateUi(self, MainWindow): 
_translate=QtCore.QCoreApplication.translate 
MainWindow.setWindowTitle(_translate("MainWindow","Main\ 
self.label.setText(_translate("MainWindow","# %4")) 
self.pushButton.setText(_translate("MainWindow"," ffi xE")) 
JER Aas QFrame 与 子 控件 之 间 有 一 个 QHBoxLayout。 可 以 看 到 ， 
使 用 容器 进行 控件 布局 本 质 上 还 是 调用 布局 管理 器 进行 的 。 





3.3 QtDesigner 实 战 应 用 


通过 前 面 的 介绍 ， 我 们 基本 了 解 了 使 用 Qt Designer 的 整个 流程 以 及 
简单 的 布局 管理 。 和 掌握 了 这 些 内 容 ， 对 PyQt 也 算是 入 门 了 。 但 是 想 用 这 
些 知识 进行 实战 是 不 够 的 ， 根 据 笔 者 的 经 验 ， 新 手 学 习 PyQt 最 大 的 坑 还 
是 在 布局 管理 器 上 ， 因 此 本 市 仍然 从 布局 管理 器 入 手 ， 对 布局 管理 器 的 
一 些 细 节 和 要 点 进行 详细 介绍 ， 帮 助 读者 快速 学 会 布局 管理 器 的 高 级 应 
用 ， 并 以 此 为 基础 引出 程序 开发 的 完整 流程 ， 对 各 个 流程 进行 解读 。 

为 了 能 够 快速 理解 本 节 的 内 容 ， 我 们 先 从 Qt Designer 入 手 对 与 布局 
相关 的 一 些 基 本 概念 进行 解读 。 

打开 Qt Designer， 新 建 一 个 主 窗口 (Main Window) ， 然 后 从 左 侧 
的 Buttons 栏 拖 动 一 个 Push Button 放 到 窗口 中 ， 并 重 命 名 为 “开始 "。 查 看 
右 侧 的 属性 编辑 器 ， 这 里 重点 对 geometry、sizePolicy、minimumSize、 
maximumSize 属性 进行 解 恋 ， 如 图 3-26 所 示 。 明 白 了 这 几 个 属性 ， 也 就 
明白 了 控件 在 窗口 中 的 位 置 是 如 何 确定 的 。 











属性 编辑 器 ax 





$= / 
pushButton : QPushButton 
属性 值 
enabled z 
(215,140), 75x25 
> sizePolicy [Minimum, Fixed, 0, 0] 
> minimumSize 0x0 
vV maximumSize 16777215 x 16777215 
宽度 16777215 
高 度 16777215 
Y sizelncrement 0x0 
宽度 0 
图 3-26 
3.3.1 绝对 布局 





最 简单 的 布局 方法 就 是 设置 geometry 这 个 属性 。Geometry 属 性 在 
PyQt 中 主要 用 来 设置 控件 在 窗口 中 的 绝对 坐标 与 控件 自身 的 大 小 ， 如 图 
3-27 FAN © 


[(215, 140), 75 x 23] 
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图 3-27 








这 里 设置 的 意思 是 ， 这 个 按钮 控件 左上 角 距 离 主 窗口 左 侧 为 
215px， 上 侧 为 140px， 控 件 宽 上 度 为 75px， 高 度 为 23px。 对 应 的 代码 如 
T 





self.pushButton=QtWidgets.QPushButton(self.centralwidget) 
self.pushButton.setGeometry(QtCore.QRect(215,140,75,23)) 
self.pushButton.setObjectName("pushButton") 
你 可 以 随意 更 改 这 些 属 性 值 来 得 看 控件 在 窗口 中 的 位 置 变化 ， 也 可 
以 通过 更 改 控件 在 窗口 中 的 位 置 及 其 大 小 来 得 看 属性 值 的 变化 ， 以 此 更 
深刻 地 理解 属性 的 含义 。 
通过 以 上 方法 ， 我 们 可 以 对 任何 一 个 窗口 控件 按照 要 求 进行 布局 。 
这 就 是 最 简单 的 绝对 布局 。 
作为 一 个 完整 的 示例 ， 我 们 在 其 中 再 添加 一 些 控 件 。 从 Display 
Widgets 栏 找到 Label 控 件 ， 以 及 从 Input Widgets 栏 找到 Double Spin Box 
控件 ， 将 它们 拖 鼻 到 主 衫 口中， 如 图 3-28 所 示 。 
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0.00 $ 0.00 KE 
TextLabel img : 
TextLabel 0. 00 ° | 0. 00 = a= 
TextLabel 0. 00 了 0.00 了 
图 3-28 


然后 对 label 和 doubleSpinBox 控 件 进行 重 命 名 (对 于 doubleSpinBox 


控件 ， 依 次 命名 为 doubleSpinBox_returns_min、 
doubleSpinBox_returns_max. doubleSpinBox_maxdrawdown_min, 
doubleSpinBox_maxdrawdown_max. doubleSpinBox_sharp_min#ll 
doubleSpinBox_sharp_max) ， 如 图 3-29 所 示 。 
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图 3-29 





这 样 对 一 些 窗口 控件 就 完成 了 界面 布局 。 对 应 的 部 分 代码 如 下 : 


self.label = QtWidgets.QLabel (self.centralwidget) 
self.label.setGeometry (QtCore.QRect (140, 80, 54, 12)) 
self.label.setObjectName ("label") 


self.doubleSpinBox returns max = 
QtWidgets.QDoubleSpinBox (self.centralwidget) 
self.doubleSpinBox returns max.setGeometry (QtCore.QRect (220, 100, 62, 
227) 








self.doubleSpinBox returns max.setObjectName 
("doubleSpinBox returns max") 





3.3.2 局 管理 恬 布 后 





在 3.3.1 节 “绝对 布局 "中 ， 我 们 通过 设置 每 个 窗口 控件 的 绝对 坐标 和 
大 小 ， 对 其 进行 了 布局 管理 。 但 是 这 样 做 每 次 都 要 手工 矫正 位 置 ， 感 觉 





非常 麻烦 ， 而 且 有 时 候 会 要 求 窗口 控件 随 着 窗口 的 大 小 而 动态 调整 自己 
的 大 小 ， 这 时 候 布 局 管理 器 就 派 上 用 场 了 。 

BRAE 32 节 “ 布 局 管理 入 门 ? 中 已 经 介绍 了 布局 管理 器 的 使 用 方 
法 ， 但 是 在 实际 应 用 中 ， 布 局 管理 器 的 使 用 远 没 有 这 么 简单 ， 本 节 将 通 
过 一 个 相对 复杂 的 案例 来 介绍 布局 管理 器 相对 高 端的 用 法 。 虽 然 本 节 有 
些 内 容 与 前 面 会 有 重复 ， 但 是 相信 读者 看 完 本 节 之 后 会 有 新 的 收获 。 

我 们 注意 到 图 3-30 左 侧 第 一 列 有 3 行 数据 ， 第 二 列 和 第 三 列 分 别 有 4 
行 数据 ， 这 样 不 便于 进行 布局 管理 ， 因 此 在 “收益 ”标签 上 面 再 添加 一 个 
标签 ， 并 命名 为 空 。 

1. 垂 直 布 局 

选中 左 侧 的 4 个 标签 ， 单 击 鼠 标 右键 ， 在 弹出 的 快捷 菜单 中 选择 “ 布 
局 ”~ “垂直 布局 ”， 效 果 如 图 3-30 所 示 。 图 中 左 侧 托 形 框 中 的 4 个 标签 在 
布局 管理 器 中 是 按照 纵向 排列 的 。 
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Sharp 比 0.00 £ 0.00 2) 
图 3-30 
对 应 的 代码 如 下 : 


self.verticalLayout=QtWidgets.QVBoxLayout() 


self.verticalLayout.setObjectName("verticalLayout") 


self.verticalLayout.addWidget(self.label_6) 
self.verticalLayout.addWidget(self.label_3) 
self.verticalLayout.addWidget(self.label_4) 
self.verticalLayout.addWidget(self.label_5) 
注意 
Bee ae beer Tt Eee 
务 多 辑 时 ， 不 会 与 这 些 Label 控 件 有 任何 交集 。 也 就 是 说 ， 这 些 Label 控 
件 的 作用 仅仅 是 显示 “收益 ”最 大 回 撤 ”sharp 比 ”这些 名 字 ， 当 对 这 些 
Label 进 行 章 命 名 时 ， 它 们 的 使 命 也 就 完成 了 。 如 果 以 代码 形式 来 写 这 
些 Label， 那 么 肯定 是 要 给 它们 起 个 名 字 的 ， 而 使 用 Qt Designer 则 没有 这 
个 烦恼 ， 这 也 是 使 用 Qt Designer 的 好 处 之 一 。 
注意 到 使 用 布局 管理 器 之 后 ， 在 属性 编辑 器 中 看 到 这 4 个 标签 的 
geometry 属 性 变 成 了 灰色 不 可 用 ， 这 说 明 这 些 标签 的 位 置 与 大 小 已 经 由 
垂直 布局 管理 器 接管 ， 与 geometry 无 关 了 。 我 们 查看 源 代 码 ， 也 可 以 发 
现 这 时 候 已 经 没有 类 似 于 
self.label.setGeometry(QtCore.QRect(140,80,54,12)) 
这 样 的 代码 了 。 
2. 网 格 布局 
选中 中 间 两 列 的 8 个 窗口 控件 ， 单 击 鼠 标 右键 ， 在 弹出 的 快捷 菜单 
中 选择 “布局 ” ~“ 栅 格 布局 ”， 效 果 如 图 3-31 所 示 。 
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图 3-31 





栅 格 布局 的 意思 就 是 该 布局 管理 器 的 窗口 呈 网 格 状 排列 。 本 来 这 8 

个 零散 的 窗口 控件 就 是 要 呈 网 格 状 排列 的 ， 因 此 使 用 栅 格 布局 管理 莫 正 
好 合适 。 对 应 的 代码 如 下 : 

self.gridLayout=QtWidgets.QGridLayout() 

self.gridLayout.setObjectName("gridLayout") 

self.gridLayout.addWidget(self.label,0,0,1,1) 

# gridLayout.addWidget( 窗 口 控件 , 行 位 置 , 列 位 置 ,要 合并 的 行 数 ,要 

合并 的 列 数 ) ， 后 两 个 是 可 选 参数 
self.gridLayout.addWidget(self.label_2,0,1,1,1) 
self. gridLayout.addWidget(self.doubleSpinBox_returns_min,1,0,1,1) 








self. gridLayout.addWidget(self.doubleSpinBox_returns_max,1,1,1,1) 
self.gridLayout.addWidget(self.doubleSpinBox_maxdrawdown_min,2 
self.gridLayout.addWidget(self.doubleSpinBox_maxdrawdown_max,z 
self.gridLayout.addWidget(self.doubleSpinBox_sharp_min,3,0,1,1) 
self. gridLayout.addWidget(self.doubleSpinBox_sharp_max,3,1,1,1) 
3. 水 平 布局 
从 Spacers 栏 分 别 将 Horizontal Spacer 和 Vertical Spacer 窗 口 控件 拖 入 
主 窗 口中 ， 从 Display Widgets 栏 将 Horizontal Line 窗 口 控件 拖 入 主 窗口 


中 ， 效 果 如 图 3-32 所 示 。 
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图 3-32 


è Vertical Spacer 表 示 两 个 布局 管理 器 不 要 彼此 挨 着 ， 盏 则 视觉 效果 
会 不 好 看 。 
e Horizontal Spacer 表 示 “ 开 始 ” 按 钮 应 该 与 机 格 布局 管理 器 尽 可 能 离 
得 远 一 些 ， 人 否则 视觉 效果 也 会 不 好 看 。 
e Horizontal Line 表示 “开始 ”按钮 与 左边 的 两 个 布局 管理 器 根本 不 
是 同一 个 类 别 ， 用 一 条 线 把 它们 区 分 开 来 。 
对 应 的 代码 如 下 : 
self.line=QtWidgets.QFrame(self.widget) # 设置 Horizontal Line 
self.line.setFrameShape(QtWidgets.QFrame. VLine) 
self.line.setFrameShadow(QtWidgets.QFrame.Sunken) 





self.line.setObjectName("line") 

spacerltem1=QtWidgets.QSpacerltem(200,20,QtWidgets.QSizePolicy 
# WH Horizontal Spacer， 注 意 200 是 自己 手动 调整 的 结果 ， 下 和 面 会 给 
出 说 明 

spacerltem=QtWidgets.QSpacerltem(20,40,QtWidgets.QSizePolicy.M 
# 设置 Vertical Spacer 











然后 ， 选 中 所 有 的 窗口 控件 ， 单 击 鼠 标 右键 ， 在 弹出 的 快捷 菜单 中 
选择 “布局 ” “水 平 布 局 ”， 效 果 如 图 3-33 所 示 。 
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图 3-33 








感觉 “开始 ”按钮 应 该 离 布 局 管理 器 更 远 一 些 比 较 合适 ， 所 以 单 击 
horizontalSpacer， 更 改 sizeType 属 性 为 preferred， 更 改 sizeHint 的 宽度 为 
200。 这 样 做 的 意思 是 horizontalSpacer 窗 口 控件 希望 (preferred) 达到 尺 
寸 提示 (sizeHint) 的 尺寸 200x20。 

最 后 ， 保 存 ， 单 击 菜 单 “ 窗 体 ” “预览 ?”， 效 末 如 图 3-34 所 示 。 
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图 3-34 


可 以 看 出 ， 呈 现 的 结果 基本 上 符合 我 们 对 布局 管理 的 预期 。 对 应 的 
代码 如 下 : 
class Ui_LayoutDemo(object): # 这 里 修改 了 主 窗口 的 对 象 名 为 


LayoutDemo 








def setupUi(self, LayoutDemo): 
LayoutDemo.setObjectName("LayoutDemo") # 创建 主 窗口 
LayoutDemo.resize(800,600) 
self.centralwidget=QtWidgets.QWidget(LayoutDemo) 
# centralwidget 的 父 类 是 主 窗口 
self.centralwidget.setObjectName("centralwidget") 
self. layoutWidget=QtWidgets.QWidget(self.centralwidget) 
# layoutWidgeth <2 K Ncentralwidget 
self. layoutWidget.setGeometry(QtCore.QRect(90,90,391,161)) 
self. layoutWidget.setObjectName("layoutWidget") 
self. horizontalLayout=QtWidgets.QHBoxLayout(self.layoutWid¢ 
# horizontalLayout 的 父 类 是 layoutWidget 
self.horizontalLayout.setObjectName("horizontalLayout") 
# horizontalLayout 也 有 很 多 子 类 
self.horizontalLayout.addLayout(self.verticalLayout) 
self.horizontalLayout.addItem(spacerItem) 
self.horizontalLayout.addLayout(self.gridLayout) 
self.horizontalLayout.addWidget(self.line) 
self.horizontalLayout.addItem(spacerItem1) 
self.horizontalLayout.addWidget(self.pushButton) 
需要 说 明 的 是 ，PyQt 有 一 个 基本 原则 : 主 窗口 中 的 所 有 窗口 控件 都 
有 自己 的 父 类 。 从 上 面 代码 中 可 以 看 到 ， 从 主 窗口 LayoutDemo 到 窗口 
控件 是 如 何 一 步 步 继 承 传 递 的 ， 这 些 事情 都 不 需要 我 们 操心 ， 因 为 Qt 








Designer 己 经 帮助 做 好 了 ， 这 也 是 使 用 Qt Designer 的 方便 之 处 之 一 。 

绍 minimumSize、maximumSize 和 sizePolicy 属 性 。 之 所 以 
要 介绍 这 三 个 属性 ， 是 因为 使 用 布局 省 理 嚣 之后， 控件 在 布局 管理 器 中 
a 它们 来 描述 

4.minimumSize 和 maximumSize 属 性 

minimumSize 和 maximumSize 属 性 用 来 设置 控件 在 布局 管理 器 中 的 
最 小 尺寸 和 最 大 尺寸 ， 我 们 对 Button GHA) 的 这 两 个 属性 按照 图 3-35 
所 示 进 行 设置 。 











St 值 
v minimumSize 100 x 100 

宽度 100 
| lake 100 
v maximumSize 300 x 300 

ae 300 

高 度 300 y 

图 3-35 
对 应 的 代码 如 下 : 


self.pushButton.setMinimumSize(QtCore.QSize(100,100)) 
self.pushButton.setMaximumSize(QtCore.QSize(300,300)) 
然后 选择 最 顶层 的 布局 管理 器 进行 压缩 或 伸展 。 这 里 有 一 个 很 方便 
的 选择 方法 一 一 因为 布局 管理 费 特 别 小 ， 用 鼠标 基本 很 难 选择 成 功 ， 所 
以 可 以 在 对 象 查 看 器 中 进行 选择 ， 如 图 3-36 所 示 。 
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图 3-36 





我 们 看 到 ， 无 论 如 何 压 缩 这 个 按钮 ， 都 不 可 能 让 它 的 宽度 和 高 度 小 
于 100; 无 论 如 何 伸展 这 个 布局 管理 器 ， 都 不 可 能 让 它 的 宽度 和 高 度 大 
于 300， 如 图 3-37、 图 3-38 所 示 。 
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图 3-37 
注意 
这 个 “开始 ”按钮 的 高 度 其 实 是 100， 只 是 该 控件 的 下 面 有 一 部 分 “ 游 
出 * 了 布局 管理 器 ， 如 图 3-38 所 示 。 
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图 3-38 





为 了 不 影响 下 面 的 分 析 ， 我 们 把 “开始 ”按钮 的 这 两 个 属性 还 原 为 默 
认 设 置 。 在 每 个 属性 的 右上 侧 都 有 一 个 还 原 的 快捷 入 口 ， 如 图 3-39 所 
示 ， 扩 击 之 后 就 可 以 还 原 为 默认 设置 了 。 


pushButton : QPushButton 
Property Value 


QObject 


QWidget 


enabled M 


> geometry [(370, 130), 75 x 23] 
> sizePolicy [Minimum, Fixed, 0, 0] 


> minimumSize 0x0 








图 3-39 


5. 属性 
在 介绍 sizePolicy 属 性 之 前 ， 我 们 需要 对 sizeHint 和 minisizeHint 有 一 





个 窗口 控件 都 有 属于 自己 的 两 个 尺寸 : 一 个 是 sizeHint( 尺 寸 提 
ia ; 一 个 是 minimumSize (最 小 尺寸 ) 。 前 者 是 窗口 控件 的 期 望 尺 
寸 ， 后 者 则 是 窗口 控件 压缩 时 所 能 够 被 压缩 到 的 最 小 尺寸 。 

sizePolicy ”的 作用 是 ， 如 果 窗 口 控件 在 布局 管理 器 中 的 布局 不 能 满 
中 我 们 的 需求 ， 那 么 束 可 以 设置 该 窗口 控件 的 sizePolicy 来 实现 布局 的 微 
调 。sizePolicy 也 是 每 个 窗口 控件 所 特有 的 属性 ， 不 同 的 窗口 控件 的 
sizePolicy 可 能 不 同 。 

如 图 3-40 所 示 是 按钮 控件 的 默认 sizePolicy 设 置 。 
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图 3-40 


对 应 的 代码 如 下 : 
sizePolicy=QtWidgets.QSizePolicy(QtWidgets.QSizePolicy.Fixed,Qt\ 
sizePolicy.setHorizontalStretch(0) # 水 平 伸展 0 
sizePolicy.setVerticalStretch(0) # 垂直 伸展 0 
sizePolicy.setHeightForWidth(self.pushButton.sizePolicy().hasHeightl 
self.pushButton.setSizePolicy(sizePolicy) 

对 于 水 平 策略 和 垂直 集 略 ， 相 关 的 解释 如 下 。 

e Fixed: 窗口 控件 具有 其 sizeHint 所 提示 的 尺寸 且 尺 寸 不 会 再 改 











e Minimum: 窗口 控件 的 sizeHint 所 提示 的 尺寸 就 是 它 的 最 小 尺 
T; 该 窗口 控件 不 能 被 压缩 得 比 这 个 值 小 ， 但 可 以 变 得 更 大 。 

° Maximum: 窗口 控件 的 sizeHint 所 提示 的 尺寸 就 是 它 的 最 大 尺 
T: 该 窗口 控件 不 能 变 得 比 这 个 值 大 ， 但 它 可 以 被 压缩 到 minisizeHint 给 
定 的 尺寸 大 小 。 

e Preferred: 窗口 控件 的 sizeHint 所 提示 的 尺寸 就 是 它 的 期 望 尺 
寸 ， 该 窗口 控件 可 以 缩小 到 minisizeHint 所 提示 的 尺寸 ， 也 可 以 变 得 比 
sizeHint 所 提示 的 尺寸 还 要 大 。 

e Expanding: 窗口 控件 可 以 缩小 到 minisizeHint 所 提示 的 尺寸 ， 也 
可 以 变 得 比 sizeHint 所 提示 的 尺寸 大 ， 但 它 希 望 能 够 变 得 更 大 。 

e MinimumExpanding: 窗口 控件 的 sizeHint 所 提示 的 尺寸 就 是 它 的 
最 小 尺寸 ;该 窗口 控件 不 能 被 压缩 得 比 这 个 值 还 小 ， 但 它 和 希望 能 够 变 得 
更 大 。 

e Ignored: 无 视窗 口 控 件 的 sizeHint 和 minisizeHint 所 提示 的 尺 
寸 ， 按 照 默 认 来 设置 。 

值得 注意 的 是 ，Minimum 指 的 是 该 窗口 控件 的 尺寸 不 能 低 于 








sizeHint 所 提示 的 尺寸 ，Maximum 指 的 是 该 窗口 控件 的 尺寸 不 能 高 
sizeHint 所 提示 的 尺寸 。 这 与 我 们 平常 所 理解 的 Minimum 和 Maximum 的 
含义 有 些 差别 。 

关于 水 平 伸展 和 季 直 伸展 ， 可 以 通过 一 个 简单 的 例子 来 理解 。 

我 们 设置 “收益 “最 大 回 撤 ”sharp 比 ”这 三 个 标签 的 垂直 伸展 分 别 为 
1、3 和 1， 然 后 拉 宽 horizontalLayout， 效 果 如 图 3-41 所 示 。 
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图 3-41 


可 以 看 到 , “收益 ”最 大 回 撤 ”sharp 比 ?这 三 个 标签 会 分 别 按照 1 : 
3 : 1 来 放 缩 。 对 应 的 代码 如 下 : 


sizePolicy = QtWidgets.QSizePolicy ( 
OQtWidgets.QSizePolicy.Preferred, QtWidgets.QSizePolicy. Preferred) 
sizePolicy.setHorizontalStretch (0) 


sizePolicy.setVerticalStretch (1) 


sizePolicy.setHeightForWidth (self.label 3.sizePolicy(). 
hasHeightForWidth () ) 
self.label 3.setSizePolicy (sizePolicy) 


sizePolicy = QtWidgets.QSizePolicy ( 
OtWidgets.QSizePolicy.Preferred, QtWidgets.QSizePolicy. Preferred) 

sizePolicy.setHorizontalStretch (0) 

sizePolicy.setVerticalStretch (3) 

sizePolicy.setHeightForWidth(self.label 4.sizePolicy(). 
hasHeightForWidth () ) 

self.label 4..setSizePolicy (sizePolicy) 


sizePolicy = QtWidgets.QSizePolicy ( 

QtWidgets.QSizePolicy. Preferred, QtWidgets.QSizePolicy. Preferred) 
sizePolicy.setHorizontalStretch (0) 
sizePolicy.setVerticalStretch (1) 
sizePolicy.setHeightForWidth ( 

self.label 5.sizePolicy(). hasHeightForWidth () ) 
self:label 5.setSizePolicy (sizePolicy) 


人 至此， 我 们 基本 上 可 以 按照 自己 的 要 求 对 窗口 控件 进行 布局 管 
了 ， 对 于 绝 大 部 分 程序 界面 ， 都 可 以 使 用 这 种 方式 进行 布局 管理 。 
在 里 面 添加 一 些 高 级 控件 来 实现 特定 的 功能 ， 在 后 面 的 章节 中 会 讲述 。 











3.3.3 其 他 震 要 注意 的 内 容 


前 面 我 们 对 PyQt 布 局 管理 做 了 详细 介绍 ， 对 于 一 般 的 应 用 程序 来 
说 ， 学 会 这 些 已 经 基本 可 以 满足 需求 了 。 但 是 PyQt 作 为 一 个 能 够 开发 大 
型 系统 的 框架 ， 其 功能 不 仅仅 局 限于 此 ， 接 下 来 通过 Qt Designer 来 解释 
其 他 相关 内 容 。 

1.Qt Designer 布 局 的 顺序 

使 用 Qt Designer 开 发 一 个 完整 的 GUI 程序 流程 如 下 . 

(1) 将 一 个 窗口 控件 拖 入 窗口 中 并 放置 在 大 致 正确 的 位 置 上 。 除 
了 容器 (container) 窗口 ， 一 般 不 需要 调整 窗口 的 尺寸 大 小 。 











(2) 对 于 要 用 代码 引用 的 窗口 控件 ， 应 指定 一 个 名 字 ; 对 于 需要 
微调 的 窗口 控件 ， 可 以 设置 其 对 应 的 属性 。 

(3) 重复 步骤 1 和 2， 直 到 所 需要 的 全 部 窗口 控件 都 放 到 了 窗口 
中 。 








(4) 如 有 需要 ， 在 窗口 控件 之 间 可 以 用 Vertical Spacer、 
Horizontal Spacer. Horizontal Line, Vertical Line 隔 开 〈 实 际 上 前 两 步 就 
可 以 包含 这 部 分 内 容 ) 。 

(5) 选择 需要 布局 的 窗口 控件 ， 使 用 布局 管理 器 或 者 切 分 窗口 

(splitter) 对 它们 进行 布局 。 

(6) 重复 步骤 5， 直 到 所 有 的 窗口 控件 和 分 隅 符 都 布局 好 为 止 。 

(7) 单 击 窗 口 ， 并 使 用 布局 管理 器 对 其 进行 布局 。 

(8) 为 窗口 的 标签 设置 伙伴 关系 。 

(9) 如 果 按 键 次 序 有 问题 ， 则 需要 设置 窗口 的 Tab 键 次 序 。 

(10) 在 适当 的 地 方 为 内 置 的 信号 和 覃 建立 信号 与 槽 连接 。 

(11) 预览 窗口 ， 并 检查 所 有 的 内 容 能 售 按 照 设 想 进 行 工作 。 

(12) 设置 窗口 的 对 象 名 《在 类 中 会 用 到 这 个 名 字 ) 、 窗 口 的 标题 
并 进行 保存 。 

(13) 使 用 Eric 或 有 类 似 功能 的 工具 〈 如 在 命令 行 中 使 用 pyuic5 ) 
编译 窗口 ， 然 后 根据 需要 生成 对 话 框 代码 (Eric 在 逻辑 文件 上 建立 信号 
与 槽 连接 的 方式 ， 本 章 会 在 3.4.2 节 “快速 进 阶 ”中 进行 介绍 ) 。 

(14) 进行 正常 的 代码 编写 工作 ， 即 编写 业务 逻辑 文件 。 

我 们 看 到 ， 步 骤 1 一 6 和 11 一 14 前 面 已 经 介绍 过 了 ， 只 有 步骤 7 一 10 
还 没有 介绍 ， 下 面 开 始 介绍 步骤 7 一 9， 最 后 介绍 步骤 10。 

2. 使 用 布局 管理 器 对 窗 体 进行 布局 

使 用 布局 管理 器 对 窗 体 进行 布局 是 针对 整个 窗 体 的 。 一 般 情 况 下 ， 
当 想 要 将 窗口 控件 塞 满 整 个 窗 体 时 才 会 考虑 对 窗 体 进 行 布 局 。 本 示例 仅 
仪 演示 将 窗口 控件 显示 在 窗 体 的 部 分 空间 ， 因 此 用 不 到 窗 体 级 别 的 布局 





























管理 。 

使 用 布局 管理 器 对 窗 体 进 行 布局 的 方法 是 ， 单 击 窗 体 〈 就 是 在 窗 体 
空白 处 单 击 ， 注 意 不 要 单 击 任何 控件 ) ， 然 后 单 击 鼠 标 右 键 ， 在 弹出 的 
快捷 菜单 中 选择 “布局 ” = “水平 布局 〈 或 王 直 布局 ) ”， 效 果 如 图 3-42 所 
示 。 
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图 3-42 





可 以 看 到 布局 管理 器 充满 了 整个 屏幕 ， 这 不 是 我 们 想 要 的 结果 ， 上 所 
以 撤销 这 个 操作 。 
针对 不 合理 的 布局 ， 还 有 一 种 比较 实用 的 解决 方法 是 打破 布局 。 单 


击 窗 体 ， 然 后 单 击 鼠 标 右 键 ， 在 弹出 的 快捷 菜单 中 选择 < 布局” o “打破 
布局 ”， 可 以 看 到 效果 和 撤销 操作 一 致 。 打 破 布局 适用 于 布局 错 了 很 多 
步 的 情况 ， 此 时 使 用 撤销 方法 没有 打破 布局 后 进行 重新 布局 方便 。 

3. 设 置 伙伴 关系 

我 们 将 “sharp 比 ”标签 重 命 名 为 “&sharp 比 ”， 然 后 单 击 且 
单 “Edit” >“ 编辑 伙伴 ”"， 用 鼠标 左 键 按 住 “sharp 比 ” 标 签 不 动 ， 同 右 拉动 
到 “doubleSpinBox_sharp_min”， 如 图 3-43 所 示 。 
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图 3-43 


对 应 的 代码 如 下 : 
self.label_5.setBuddy(self.doubleSpinBox_sharp_min) 
lea, WF AKE AA” > “预览 窗 体 ”〈 或 按 “Ctrl+R” 快 捷 
HE) 





这 时 候 我 们 按 “Alt+S” 快 捷 键 ， 会 发 现 光 标 快速 定位 
到 “doubleSpinBox_sharp_min”， 这 就 是 label 和 doubleSpinBox 之 间 的 伙 
伴 关 系 。 对 Display Widgets 设 置 快 捷 键 ， 当 触发 快捷 键 时 ， 光 标 会 立刻 
定位 到 与 Display Widgets 有 伙伴 关系 的 mput Widgets 上 。 

需要 注意 的 是 ， 设 置 伙伴 关系 只 对 秽 文 名 字 有 的 Display ”Widgets 有 
效 ， 访 示例 的 显示 名 字 大 多 数 是 中 文 的 ， 所 以 “收益 ”和 “最 大 回 撤 * 这 两 
个 标签 实际 上 是 设置 不 了 伙伴 关系 的 。 

4. 设 置 Tab 键 次 序 

单 击 采 单 和 全 dit” “设置 Tab 刍 次序 ”"， 效 果 如 图 3-44 所 示 。 
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图 3-44 


图 3-44 中 所 示 的 1 一 7 数字 表示 我 们 按 Tab 键 时 光标 跳动 的 顺序 。 这 
个 顺序 符合 预期 ， 所 以 就 不 用 修改 了 。 
如 果 想 要 对 这 个 次 序 进行 修改 ， 只 再 按照 目 己 想 要 的 顺序 依次 点 击 
这 7 个 空间 就 可 以 了 。 
这 里 推荐 力 一 种 设置 Tab 键 次 序 的 方法 : 单 击 鼠 标 右键 ， 在 弹出 的 








快捷 菜单 中 选择 “ 制 表 符 顺 序列 表 *， 打 开 “ 制 表 符 顺 序列 表 ” 窗 口 ， 如 图 
3-45 所 示 。 
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图 3-45 
在 这 里 ， 你 可 以 选择 某 一 个 控件 ， 然 后 上 下 拖 动 ， 其 他 控件 的 顺序 
就 会 进行 相应 的 调整 。 
至 此 ， 束 基本 介绍 完了 使 用 Qt Designer 进 行 布 局 管理 的 所 有 内 容 ， 
接 下 来 是 时 候 测 试 一 下 这 个 程序 了 。 


3.3.4 测试 程序 


我 们 利用 3.1.4 节 的 方法 ， 使 用 Eric 6 将 
layout_demo_LayoutManage.ui 编译 为 


Ui_layout_demo_LayoutManage.py， 然 后 新 建 一 个 文件 
layout_demo_LayoutManage.py， 并 写 入 下 面 的 代码 : 


非 一 二 二 coding: utf-8 =*= 


nnn 


Module implementing LayoutDemo. 


nnn 


from PyQt5.QtCore import pyqtSlot 
from PyQt5.QtWidgets import QMainWindow, QApplication 


from Ui layout demo LayoutManage import Ui LayoutDemo 


class LayoutDemo(QMainWindow, Ui _LayoutDemo) : 


nnn 


Class documentation goes here. 


def init (self, parent=None) : 


nun 


Constructor 


@param parent reference to the parent widget 
@type QWidget 

super (LayoutDemo, self). init (parent) 
self.setupUi (self) 


@pygtSlot () 
def on_pushButton_clicked(self): 


woe 


Slot documentation goes here. 


woe 


print ("Ks min:',self.doubleSpinBox_ returns _min.text()) 

print ("Kk# max:',self.doubleSpinBox returns max.text()) 

print ("RAM min:',self.doubleSpinBox_maxdrawdown min. 
text ()) 

print ("RAW max:',self.doubleSpinBox maxdrawdown_max. 
text ()) 

print ('sharp lt min:',self.doubleSpinBox sharp min.text ()) 


print ('sharp Ht_max:',self.doubleSpinBox_sharp_max.text () ) 


Hele eet a ewes 


import sys 


app = QApplication(sys.argv) 
ui = LayoutDemo () 
ui.show () 


sys.exit (app.exec ()) 

注意 

对 于 如 下 代码 : 

@pydtSlot() 

def on_pushButton_clicked(self): 

需要 做 一 些 解释 一 一 这 里 实际 上 利用 了 Eric 的 “生成 对 话 框 代码 ”的 
功能 ， 它 是 Eric 在 馆 辑 文件 上 建立 信号 与 槽 连接 的 方式 ， 本 草 会 在 3.4.2 
节 “ 快 速 进 阶 "中 进行 说 明 。 关 于 信和 号 与 槽 的 更 详细 的 用 法 ， 会 在 第 7 章 








运行 程序 ， 对 窗口 中 doubleSpinBox 进 行 修改 ， 如 图 3-46 所 示 。 
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图 3-46 


单 击 “ 开 始 ” 按 钮 ， 会 看 到 控制 台 输 出 如 图 3-47 所 示 的 内 容 ， 结 果 符 
合 预 期 。 





图 3-47 


3.4 信号 和 模 关 联 


信号 (signal) As (slot) 是 Qt 的 核心 机 制 。 Ce 
后 ， le 号 和 覃 的 连接 就 可 以 实现 对 象 之 间 的 通信 。 当 信和 号 发 射 
Cemit) 时 ， 连 接 的 槽 函数 将 会 自动 执行 。 在 PyQt SH, fa SAH 
QObject.signal.connect() 连 接 。 

所 有 从 QObject 类 或 其 子 类 (如 QWidget) 派生 的 类 都 能 够 包含 信 
号 和 槽 。 当 对 象 改 变 其 状态 时 ， 信 和 号 就 由 该 对 象 发 射出 去 。 模 用 于 接收 
信号 ， 但 它们 是 普通 的 对 象 成 员 函 数 。 多 个 信号 可 以 与 单个 槽 进行 连 
接 ， 单 个 信号 也 可 以 与 多 个 槽 进行 连接 。 总 之 ， 信 号 和 槽 构建 了 一 种 强 
大 的 控件 编程 机 制 。 

在 Qt 编程 中 ， 通 过 Qt 信号 槽 机 制 对 鼠标 或 键盘 在 界面 上 的 操作 进行 
啊 应 处 理 ， 例 如 对 鼠标 单 击 按钮 的 处 理 。Qt 中 的 控件 能 够 发 射 什 么 信 
号 ， 以 及 在 什么 情况 下 发 射 信 号 ， 在 Qt 的 文档 中 有 说 明 ， 不 同 的 控件 能 
够 发 射 的 信号 种 类 和 触发 时 机 也 是 不 同 的 。 

那么 如 何 为 控件 发 射 的 信号 指定 对 应 的 处 理 槽 函数 呢 ? 一 般 有 三 种 
方法 ， 第 一 种 是 在 窗口 的 UI 设 计 中 操作 添加 信号 和 模 ; 第 二 种 是 通过 代 
码 连接 信号 和 槽 ; 第 三 种 是 通过 Eric 的 “生成 对 话 框 代 码 ” 的 功能 产生 信 
ARE o 

















3.4.1 简单 入 门 


Qt Designer 提 供 了 基本 的 编辑 信号 槽 方法 。 首 先 ， 新 建 一 个 模板 名 
为 “Widget” 的 简单 窗口 ， 该 窗口 文件 名 为 ”MainWinSignalSlog01.ui。 本 
例文 件 名 为 PyQt5/Chapter03/MainWinSignalSlog01.ui， 它 要 实现 的 功能 





是 ， 当 单 击 关闭 按钮 后 关闭 窗口 。 

在 Qt Designer 窗 口 左 侧 有 一 个 Buttons 栏 ， 找 到 QPushButton 控 件 ， 
把 它 拖 到 窗 体 Form 中 。 在 属性 编辑 器 中 ， 找 到 按钮 对 应 的 text 属性 ， 
把 属性 值 改 为 “关闭 窗口 ”， 并 将 objectName 属 性 值 改 为 “closeWinBtn?”， 
如 图 3-48 所 示 。 
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图 3-48 


单 击 工具 栏 上 的 “编辑 信号 / 槽 ”( 或 者 通过 单 击 “*Edit”〈 编 辑 ) 菜单 
> “编辑 信号 / 槽 ”) ， 进 入 信号 槽 编辑 模 式 ， 可 以 直接 在 发 射 者 〈“ 关 闭 
窗口 ”按钮 ) 上 按 住 鼠 标 左 键 不 放 ， 拖 动 到 接收 者 (Form 窗 体 ) 上 ， 这 
样 束 建立 起 了 连接 ， 如 图 3-49 所 示 。 








图 3-49 


接着 会 弹出 “配置 连接 ”对 话 框 ， 如 图 3-50 所 示 。 


closeWinBtn (QPushButton) Form (QWidget) 


clicked() close() A 
clicked(bool) deleteLater() 
customContextMenuRequeste hide) 
destroyed() lower() 
destroyed(QObject*) raise() 
objectNameChanged (QString) repaint() 





pressed() setFocus() 
released() show() 
“Sa showFullScreen() 




















编辑 . . . _ 编辑. . 
显示 从 Widget 继承 的 信号 和 樟 





图 3-50 





可 以 看 到 按钮 控件 会 发 射 很 多 信号 ， 只 要 选择 一 个 信号 ， 然 后 单 
击 “OK” 按 钮 ， 就 会 生成 对 应 的 横 函 数 对 按钮 发 映 的 该 信号 进行 处 理 。 

由 于 要 达到 单 击 按钮 关闭 窗口 的 效果 ， 所 以 这 里 勾 选 "显示 从 
QWidget 继 承 的 信号 和 覃 > 复 选 框 。 在 左 侧 的 closewinBtn 按 钮 的 信号 栏 
里 选择 clicked0 信 号 ， 在 右 侧 的 Form WAP close0， 这 意味 着 
对 “关闭 窗口 ”按钮 单 击 会 发 射 clicked 信 和 号， 这 个 信和 号 会 被 Form 窗 体 的 村 
函数 close0) 捕 捉 到 ， 并 触发 该 窗 体 的 close 行 为 〈 也 惑 是 关闭 该 窗 体 ) 。 

连接 信号 和 槽 成 功 后 ， 会 发 现在 “编辑 信号 / 槽 ”模式 下 ， 上 所 创建 的 信 
号 和 覃 关系 的 连 线 是 红色 的 ， 如 图 3-51 所 示 。 





Form - MainWinSignalSlog01.ui ex 








图 3-51 


将 界面 文件 转换 为 Python 文件 ， 需 要 输入 以 下 命令 把 
MainWinSignalSlog01.ui 文 件 转换 为 MainWinSignalSlog01.py 文 件 。 如 果 
命令 执行 成 功 ， 在 MainWinSignalSlog01.ui 的 同 级 目录 下 会 生成 一 个 同 
名 的 .py 文件 。 

pyuic5-o MainWinSignalSlog01.py MainWinSignalSlog01.ui 
查看 MainWinSignalSlog01.py 文 件 ， 生 成 的 代码 如 下 : 
from PyQt5 import QtCore,QtGui, QtWidgets 
class Ui_Form(object): 
def setupUi(self,Form): 
Form.setObjectName("Form") 
Form.resize(452,296) 
self.closeWinBtn=QtWidgets.QPushButton(Form) 


self.closeWinBtn.setGeometry(QtCore.QRect(150,80,121,31)) 
self.closeWinBtn.setObjectName("closeWinBtn") 
self.retranslateUi(Form) 
self.closeWinBtn.clicked.connect(Form.close) 
QtCore.QMetaObject.connectSlotsByName(Form) 

def retranslateUi(self,Form): 
_translate=QtCore.QCoreApplication.translate 
Form.setWindowTitle(_translate("Form","Form")) 
self.closeWinBtn.setText(_translate("Form","* H] ff H ")) 

在 使 用 pyuic5 命 令 生 成 的 Python 代码 中 ， 是 通过 如 下 代码 直接 连接 
closeWinBtn 按 钮 的 clicked0O 信 号 和 槽 函数 Form.close0 的 。 注 意 : 使 用 
QObject.signal.connectO 连 接 的 槽 函数 不 要 加 括号 ， 否 则 会 出 错 。 

self.closeWinBtn.clicked.connect(Form.close) 

注意 

通过 pyuic5 生成 的 代码 中 有 这 样 一 行 代码 : 
QtCore.QMetaObject.connect SlotsByName(Form)， 这 行 代 人 码 属 于 信号 与 
槽 的 高 级 应 用 ， 在 这 个 案例 中 可 有 可 无 ， 第 7 章 会 对 其 进行 重点 解读 。 

其 实现 流程 是 : 按钮 是 信号 发 射 者 ， 当 单 击 按钮 之 后 会 发 射 一 个 信 
写 ， 通 过 这 行 代码 程序 内 部 的 通信 机 制 知 道 这 个 按钮 的 单 击 事件 被 连接 
到 窗 体 的 关闭 事件 上 ， 然 后 通知 接收 者 窗 体 ， 可 以 运行 槽 函数 close0)。 

为 了 使 窗口 的 显示 和 业务 馆 辑 分 离 ， 再 新 建 一 个 调用 窗口 显示 的 文 
件 CallMainWinSignalSlog01.py， 其 完整 代码 如 下 : 

import sys 


from PyQt5.QtWidgets import QApplication ,QMainWindow 














from MainWinSignalSlog01 import Ui_Form 
class MyMainWindow(QMainWindow, Ui_Form): 


def __init__(self,parent=None): 


super(MyMainWindow,self).___init__(parent) 
self.setupUi(self) 


_ main ": 


if name == 
app=QApplication(sys.argv) 
myWin=MyMainWindow() 
myWin.show() 
sys.exit(app.exec_()) 


效果 如 图 3-52 所 示 。 





图 3-52 


3.4.2 快速 进 阶 





对 于 新 手 来 说 ， 在 学 习 信 和 号 与 槽 的 过 程 中 必须 面 对 两 个 问题 : 第 一 
个 是 PyQt 默 认 有 哪些 信号 与 槽 ， 第 二 个 是 如 何 使 用 这 些 信号 与 槽 。 





对 于 第 一 个 问题 ， 可 以 通过 图 3-50 所 示 的 方法 来 获取 默认 可 用 的 信 
号 与 槽 的 列表 。 但 是 使 用 这 种 方法 有 一 个 缺点 ， 如 果 发 现 信号 与 槽 连接 
错误 ， 使 用 这 种 方法 进行 手工 调整 容易 出 现 失 误 。 更 简单 的 方法 是 使 用 
右 下 侧 的 信号 与 槽 编辑 窗口 来 进行 调整 ， 如 图 3-53 所 示 。 














Signal/Slot Editor 8 x 
ro 

l = 
Sender Signal Receiver Slot 

checkBox clicked(bool) lineEdit er ee Mesh 
checkBox clicked(bool) label setVis… (bool 
< > 
Signal/Slot Editor Action Editor Resource Browser 











图 3-53 


本 例 涉及 的 文件 包括 MainWinSignalSlog03.ui、 
MainWinSignalSlog03.py 和 CallMainWinSignalSlog03.py。 运 行 


CallMainWinSignalSlog03.py， 结 果 如 图 3-54 所 示 。 


OE MainWindow 





图 3-54 


单 击 两 次 “选择 ”， 结 果 如 图 3-55 所 示 。 


OE MainWindow 


O 选择 





图 3-55 





涉及 的 代码 如 下 ， 表 示 当 checkBox 选择 为 真 时 ， 发 射 的 信号 会 设 
置 ]label.setVisible 和 lineEdit.setEnable 为 Trne， 反 之 亦 反 。 
self.checkBox.clicked['bool'].connect(self.label.setVisible) 
self.checkBox.clicked['bool'].connect(self.lineEdit.setEnabled) 
对 于 第 二 个 问题 ， 最 简单 的 方法 就 是 把 含有 信号 与 槽 的 .ui 文件 编译 
成 .py 文件 ， 然 后 在 .py 文件 中 找 出 相应 信号 与 槽 的 使 用 方法 。 掌 握 这 种 
方法 的 读者 ， 融 可 以 解决 实际 中 遇 到 的 绝 大 多 数 业 务 逻 辑 问题 了 。 
另外 ， 对 于 有 些 熟悉 Eric 的 读者 ， 可 能 更 倾 问 于 使 用 Eric 来 生成 信 
号 和 槽 ， 这 就 是 前 面 经 常 提 到 的 Eric 的 “生成 对 话 框 代 码 ” 的 功能 。 这 也 











是 一 种 不 错 的 方法 ， 有 具体 如 下 。 

把 MainWinSignalSlog03.ui 另 存 为 MainWinSignalSlog04.ui， 然 后 打 
开 ， 去 掉 其 中 的 信号 与 槽 并 保存 。 

切换 到 Eric 的 “ 窗 体 ? 选 项 卡 ， 选 中 MainWinSignalSlog04.ui 并 单 击 鼠 
标 右键 ， 选 择 “ 编 译 窗 体 "”， 生 成 Ui_MainWinSignalSlog04.py 文 件 。 再 单 
击 鼠 标 右键 ， 选 择 “ 生 成 对 话 框 代 码 ”， 如 图 3-56 所 示 。 
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图 3-56 


注意 

如 末 使 用 Eric 找 不 到 这 个 文件 ， 则 可 以 通过 单 击 鼠 标 右键 ， 选 择 “ 湛 
加 窗 体 ”， 然 后 在 源 文件 一 栏 添加 所 需要 的 文件 。 

执行 上 面 的 操作 后 会 弹出 一 个 和 窗口， 按照 图 3-57 所 示 进 行 设置 。 


类 名 (C): MainWindow = | ggm- 


文件 名 (F): |D: \zw_own\PyQt \my_pyqt_book\PyQ t5-codes \Chapkampaiia Tiii TS i gnalSlog(4. py 


过 滤器 (w): 单 击 “ 新 建 ”， 在 弹出 的 
> centralwidget (QWidget) 窗口 中 单 击 “Ti ke” 


v checkBox (QCheckBox) 
Leal E i 








SCT Bye 
Yon checkbox customceontext ested(QPoint 然后 选择 这 个 
C] on_checkBox_destroyed() 
[C] on_checkBox_destroyed(QObject*) 
[C] on_checkBox_objectNameChanged (QString) 
C] on_checkBox_pressed() 
C] on_checkBox_released() 
[C] on_checkBox_stateChanged(int) 
[C] on_checkBox_toggled(bool) 
[C] on_checkBox_windowIconChanged(QIcon) 
[C] on_checkBox_windowI conTextChanged (QString) 
C] on_checkBox_windowTi tleChanged(QString) 
> label (QLabel) 
» lineEdit (QLineEdit) 
> menubar (QMenuBar) 
» statusbar (QStatusBar) 














图 3-57 





单 击 “OK” 按 钮 后 ， 会 发 现在 当前 文件 夹 下 多 出 了 一 个 文件 
MainWinSignalSlog04.py， 代 码 如 下 : 





上 面 的 代码 显然 是 不 可 运行 的 ， 需 要 对 其 进行 改写 ， 改 写 后 的 代码 
如 下 文件 名 仍 为 MainWinSignalSlog04.py， 对 原文 件 进行 了 覆盖 处 
FE): 


import sys 
app = QApplication(sys.argv) 
myWin = MainWindow() 
myWin.show() 
sys.exit(app.exec ()) 
运行 上 面 文件 ， 可 以 发 现 结果 和 图 3-55 所 示 的 一 致 一 一 通过 不 同 的 
音 号 与 槽 的 触发 机 制 实现 了 相同 的 功能 。 
这 两 种 方法 都 有 自己 的 优点 ， 读 者 可 以 根据 上 自己 的 偏好 选择 任意 一 
种 方法 来 学 习 ， 也 可 以 通过 本 例 来 学 习 这 两 种 方法 是 如 何 转化 的 。 如 宋 
掌握 了 这 两 种 方法 ， 那 么 在 PyQt 的 信号 与 槽 机 制 方面 就 达到 了 中 级 水 
平 ， 因 为 你 此 时 已 经 具备 了 学 习 PyQt 的 目 我 成 长 的 能 
PyQt 的 信号 与 槽 机 制 是 其 核心 内 容 ， 第 7 章 还 会 详细 介绍 这 部 分 知 
WR o 











3.5 Se Ni TH 


3.5.1 界面 设计 


MainWindow 即 主 窗 口 ， 主 要 包含 玉 单 栏 、 工 具 栏 、 任 务 栏 等 。 双 
击 菜 单 栏 上 的 “在 这 里 输入 ”， 然 后 输入 文字 ， 最 后 按 回 车 键 即 可 生成 菜 
单 。 对 于 一 级 菜单 ， 可 以 通过 输入 “文件 (&F)” 和 “编辑 (&E)? 来 加 入 菜单 
的 快捷 键 ， 如 图 3-58 所 示 。 注 意 : 要 按 回 车 键 来 确认 菜单 的 输入 。 








MainWindow - MainForm.ui |= e 
MHF) 编辑 (E) 在 这 里 输入 


图 3-58 


在 Qt _ Designer 中 单 击 菜单 “ 窗 体 ” “预览 "， 可 以 快速 预览 所 生成 的 
窗口 效果 《或 者 按 *Ctrl+R” 快 捷 键 进行 预览 ) ， 如 图 3-59 所 示 。 


文件 (F) Edit 视图 (V) 设置 (S$) BOW) 帮助 
D Ø| fe 水 平 布局 (H) Ctrl+1 

Widget Box = 垂直 布局 (V) Ctrl+2 

falter: H ”使 用 分 型 器 水 平 布局 (P) Ctrl+3 

4 us 使 用 分 裂 器 垂直 布局 (U) Ctrl+4 

= Vertical La $3 栅 格 布局 (G) Ctrl+5 
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在 本 例 中 ， 我 们 输入 “文件 ”菜单 ， 然 后 再 输入 “打开 ”新 建 " 和 “ 关 
闭 ” 三 个 子 菜 单 。 子 菜单 可 以 通过 动作 编辑 器 或 者 属性 编辑 器 中 的 
Shortcut 来 添加 快捷 键 ， 如 图 3-60 所 示 。 


动作 编辑 器 
DPBxXA 








名 称 使 用 


| fleOpenAction 加 


fileNewAction 
filecloseAction 
addWinAction 











[ 信号 / 檀 编 辑 器 | 动作 编辑 器 | 次 
图 3-60 


双击 需要 编辑 的 动作 ， 可 以 对 其 进行 设置 并 添加 图 标 、 快 捷 键 等 ， 
如 图 3-61 所 示 。 





文本 (了) : FIH 
对 象 名 称 (D) : fileOpendction 
ToolTip: 打开 











Icon thene: | 
BFD : | Normal Off 
Checkable: a 

Shortcut: Alt+S 











| Cancel | 


图 3-61 





现在 来 添加 主 窗口 的 工具 栏 。 使 用 Qt Designer 默 认 生 成 的 主 窗口 中 
不 显示 工具 栏 ， 可 以 通过 单 击 忌 标 右键 来 添加 工具 栏 ， 如 图 3-62 所 示 。 
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在 Qt _ Designer 的 属性 编辑 器 中 新 建 addWinAction， 


3-63 上 所 示 。 
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图 3-62 


Ctri+X 
Ctrl+C 
Ctrl+V 
Ctrl+A 





其 详细 信息 如 图 


文本 (T) : 添加 窗 仁 
对 象 名 称 (N) : add¥indction 
ToolTip: 添加 窗 体 
Icon theme: | 








图 标 (ID) : | Normal Off 
Checkable: L] 


Shortcut: [Press shortcut 

















图 3-63 





可 以 通过 属性 编辑 器 来 修改 图 标的 大 小 。 工 具 栏 上 的 图 标 ， 可 以 通 
过 动作 编辑 器 建立 并 拖 入 工具 栏 中 ， 如 图 3-64 所 示 。 
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在 动作 编辑 器 中 上 自 定义 的 Action 如 表 3-1 所 示 。 


表 3-1 


对 象 名称 


fileOpenAction 





fileNewAction 








addWinAction 添加 窗 体 
最 后 ， 使 用 pyuic5 命 令 将 UI 文 件 转换 为 Python 文件 。 
pyuic5-o MainForm.py MainForm.ui 
MainForm.py 文 件 保存 在 PyQt5/Chapter03/mainWin 目 录 下 ， 其 完整 
代码 如 下 : 


from PyQt5 import QtCore, QtGui, QtWidgets 


class Ui MainWindow (object): 
def setupUi (self, MainWindow) : 

MainWindow.setObjectName ("MainWindow") 
MainWindow.resize(588, 476) 
self.centralwidget = QtWidgets.QWidget (MainWindow) 
self.centralwidget.setObjectName ("centralwidget") 
MainWindow.setCentralWidget (self.centralwidget) 
self.menubar = QtWidgets.QMenuBar (MainWindow) 
self.menubar.setGeometry (QtCore.QRect(0, 0, 588, 26)) 
self.menubar.setObjectName ("menubar") 
self.menu = QtWidgets.QMenu(self.menubar) 
self.menu.setObjectName ("menu") 
self.menu_E = QtWidgets.QMenu (self.menubar) 
self.menu_E.setObjectName ("menu_E") 
MainWindow.setMenuBar (self.menubar) 
self.statusbar = QtWidgets.QStatusBar (MainWindow) 
self.statusbar.setObjectName ("statusbar") 
MainWindow.setStatusBar (self.statusbar) 
self.toolBar = QtWidgets.QToolBar (MainWindow) 
self.toolBar.setObjectName ("toolBar") 
MainWindow.addToolBar (QtCore.Qt.TopToolBarArea, self.toolBar) 
self.fileOpenAction = QtWidgets.QAction (MainWindow) 
self.fileOpenAction.setObjectName ("fileOpenAction") 
self.fileNewAction = QtWidgets.QAction (MainWindow) 
self.fileNewAction.setObjectName ("fileNewAction") 
self.fileCloseAction = QtWidgets.QAction (MainWindow) 


self.fileCloseAction.setObjectName ("fileCloseAction") 
self.addWinAction = QtWidgets.QAction (MainWindow) 
self.addWinAction.setObjectName ("addWinAction") 
self.menu.addAction(self.fileOpenAction) 
self.menu.addAction(self.fileNewAction) 
self.menu.addAction(self.fileCloseAction) 
self.menubar.addAction(self.menu.menuAction () ) 
self.menubar.addAction(self.menu_E.menuAction() ) 
self.toolBar.addAction(self.addWinAction) 





self.retranslateUi (MainWindow) 


QtCore.QMetaObject.connectSlotsByName (MainWindow) 


def retranslateUi(self, MainWindow) : 
_translate = QtCore.QCoreApplication.translate 
MainWindow.setWindowTitle(_ translate ("MainWindow", 
"MainWindow") ) 
self.menu.setTitle(_translate("MainWindow", "文件 (&F)")) 
self.menu E.setTitle( translate ("MainWindow", "编辑 (&E)")) 


self.toolBar.setWindowTitle( translate ("MainWindow", 


"“toolBar™)) 
self.fileOpenAction.setText (_translate ("MainWindow", TATA) 
self.fileOpenAction.setShortcut(_ translate ("MainWindow", 
VATE+O™) ) 
self.fileNewAction.setText (_ translate ("MainWindow", "新 建 ") ) 
self.fileNewAction.setShortcut( translate ("MainWindow", 
"Alt+N") ) 
self.fileCloseAction.setText (translate ("MainWindow", "关闭 ") ) 
self.fileCloseAction.setShortcut( translate ("MainWindow", 
MALt+C") ) 


self.addWinAction.setText (_translate("MainWindow", "添加 窗 体 ")) 
3.5.2 效果 测 


可 以 通过 界面 文件 与 逻辑 文件 分 离 的 方式 来 测试 所 呈现 的 界面 效 
果 ， 只 需 使 用 pyuic5 命 令 将 MainForm.ui 文 件 转 换 成 MainForm.py 文 件 ， 
然后 在 CallMainWin01.py 文 件 中 导入 对 应 的 类 并 继承 就 可 以 了 。 





CallMainWin01.py 文件 保存 在 PyQt5/Chapter03/mainWin 目 录 下 ， 其 完整 
代码 如 下 : 


import sys 
from PyOt5.QtWidgets import QApplication , QMainWindow, QWidget , 


QFileDialog 
from MainForm import Ui_MainWindow 


class MainForm( QMainWindow , Ui_MainWindow) : 
det Janie (selfys 
super (MainForm,self). init () 
self.setupUi (self) 
# 菜单 的 点 击 事件 ， 当 点 击 关闭 菜单 时 连接 槽 函数 close () 
self.fileCloseAction.triggered.connect (self.close) 
# 菜单 的 点 击 事件 ， 当 点 击 打开 菜单 时 连接 槽 函数 openMsg () 


self.fileOpenAction.triggered.connect (self.openMsg) 


def openMsg(self): 
file,ok= QFileDialog.getOpenFileName (self, "4T#","C:/","All 
Files (*)/ Text Files (xE) 
# 在 状态 栏 显示 文件 地 址 
self.statusbar.showMessage (file) 
aig o ee SS ea 
app = QApplication(sys.argv) 
win = MainForm() 
win.show() 


sys.exit (app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 3-65 所 示 。 


P MainWindow - o 


个 & ， 这 台电 脑 Windows8_OS (C:) > 
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图 3-65 


运行 脚本 所 生成 的 界面 和 使 用 Qt Designer 设 计 的 界面 是 一 样 的 ， 并 
昌 在 类 的 初始 化 中 为 菜单 选项 “打开 ”和 “关闭 ”的 信号 绑 定 了 自 定义 的 槽 
函数 。 





# 荣 单 的 点 击 事件 ， 当 点 击 关 闭 荣 单 时 连接 槽 函数 close) 


self.fileCloseAction.triggered.connect(self.close) 


# LIN SEE, St TPS LIN Ee A K Z openMsg() 
self.fileOpenAction.triggered.connect(self.openMsg) 


3.5.3 MJH: 其 他 窗口 


本 节 介 绍 一 种 在 当前 窗口 中 其 入 另 一 个 窗口 的 方法 。 
(1) 首先 使 用 Qt Designer 新 建 一 个 普通 窗口 ， 命 名 


为 “ChildrenForm2， 并 在 ChildrenForm2 中 放置 QTextEdit 控 件 ， 如 图 3-66 


所 示 。 











我 是 子 窗口 的 内 容 
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Object Class 
v E ChildrenForm 国 QWidget 

textEdit Al] QTextEdit 
Property Editor a 
Filter 十 =a d 
ChildrenForm : QWidget 
Property Value 





图 3-66 


然后 复制 MainForm.ui 并 重 命 名 为 MainForm2.ui， 使 用 Qt Designer 打 
开 ， 在 主 窗口 的 空白 中 央 添 加 一 个 栅 格 布局 管理 器 并 命名 





为 “MaingridLayout”， 
示 。 


© MainWindow - Maii 


© Form - ChildrenForm2.ui* 
TEEFEDMAS 。 
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E MainForm2.ui 
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等 会 需要 将 ChildrenForm2 放 进去 ， 如 图 3-67 所 
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图 3-67 


(2) 使 用 pyuic5 命 令 将 .ui 文件 转换 为 .py 文件 。 
pyuic5-o MainForm2.py MainForm2.ui 


pyuic5-o ChildrenForm2.py ChildrenForm2.ui 


MainForm2.py 文 件 保存 在 PyQt5/Chapter03/mainWin 目 录 下 。 
(3) 调用 主 窗口 类 。 为 了 实现 调用 代码 与 界面 的 分 离 ， 需 要 新 建 
一 个 文件 CallMainWin02.py， 直 接 继 承 界 面 类 和 主 窗口 类 。 同 理 ， 子 窗 
口 类 ChildrenForm2 的 声明 也 放 在 了 调用 类 CallMainWin02.py 文件 中 。 
CallMainWin02.py 文件 保存 在 PyQt5/Chapter03/mainWin 目 录 下 ， 其 完整 
代码 如 下 : 


F —*= Coding: utf-8 —*- 


import sys 

from PyQt5.QtWidgets import QApplication, QMainWindow, QWidget, 
QFileDialog 

from MainForm2 import Ui MainWindow 

from ChildrenForm2 import Ui_ChildrenForm 


class MainForm(QMainWindow, Ui MainWindow) : 
def init (self): 
super (MainForm;: self). init () 
self.setupUi (self) 


# self.child = children() 生 成 子 窗口 实例 self.child 
self.child = ChildrenForm() 


# 菜单 的 单 击 事件 ， 当 单 击 关闭 菜单 时 连接 楼 函数 close() 
self.fileCloseAction.triggered.connect (self.close) 
# 菜单 的 单 击 事件 ， 当 单 击 打开 菜单 时 连接 楷 函 数 openMsg () 


self.fileOpenAction.triggered.connect (self.openMsg) 


# 单 击 actionTst， 子 窗口 就 会 显示 在 主 窗口 的 MaingridLayout 中 
self.addWinAction.triggered.connect (self.childShow) 


def childShow (self): 
# 添加 子 窗口 
self.MaingridLayout.addWidget (self.child) 
self.child.show() 


def openMsg(self): 
file, ok = QOFileDialog.getOpenFileName(self, iri", "C:/", "All 
Files (*)p3Text Files (* stxt) ™) 
# 在 状态 栏 显示 文件 地 址 
self.statusbar.showMessage (file) 


class ChildrenForm(QWidget, Ui_ChildrenForm) : 
def init (self): 
super (ChildrenForm, self). init  () 
self.setupUi (self) 





运行 脚本 ， 显 示 效 果 如 图 3-68 所 示 。 


OE MainWindow 


LF SSE) 
添加 窗 体 





图 3-68 





在 这 个 例子 中 ， 当 单 击 MainWindow 工具 栏 中 的 “添加 窗 体 ”按钮 
时 ， 在 主 窗口 MainForm 中 会 动态 加 载 子 窗口 ChildrenForm2。 
单 击 工 具 栏 上 的 按钮 时 ， 触 发 信号 绑 定 自 定 义 的 槽 函数 





childShow(). 
# HitactionTst, fa OMA aN te i FAY) MaingridLayout'# 
self.addWinAction.triggered.connect(self.childShow) 
def childShow(self): 
# 添加 子 窗 口 
self.MaingridLayout.addWidget(self.child) 
self.child.show() 





3.6 打包 资源 文件 


使 用 PyQt 5 生成 的 应 用 程序 引用 图 片 资 源 主要 有 两 种 方法 ， 第 一 种 
方法 是 将 资源 文件 转换 为 Python 文件 ， 然 后 引用 Python 文件 ， 第 二 种 
方法 是 在 程序 中 通过 相对 路 径 引 用 外 部 图 片 资 源 。 由 于 第 一 种 方法 会 涉 
及 Qt Designer， 所 以 放 在 本 章 介绍 ; 对 于 第 二 种 方法 ， 使 用 起 来 非常 简 
单 ， 读 者 可 以 查看 第 4 章 中 的 案例 4-7。 下 面 详细 介绍 第 一 种 方法 的 实现 
过 程 。 











3.6.1 t Designer 加 载 资源 让 


在 Qt Designer 中 设计 界面 时 是 不 能 直接 加 入 图 片 和 图 标 等 资源 的 ， 
而 是 需要 在 PyQt 开 发 目录 下 编写 .qrc 文 件 〈 可 以 用 文本 编辑 器 打开 扩展 
名 为 .qrc 的 资源 文件 ) 。 
(1) 新 建 一 个 资源 文件 apprcc.qrc， 它 的 内 容 如 下 : 
< rcc version="1.0" > 
< qresource > 
< /qresource > 
< /rcc > 
也 可 以 使 用 Eric 创 建 这 个 文件 ， 操 作 如 图 3- 69 所 示 。 然 后 在 弹出 的 
窗口 中 新 建文 件 apprcc.qrc 就 可 以 了 ， 它 会 自动 帮 你 生成 上 面 的 代码 。 
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图 3-69 
(2) 打开 Qt Designer， 新 建 一 个 类 型 为 Widget 的 简单 窗 体 ， 该 窗 


体 文件 名 为 MainWin02.ui。 然 后 打开 资源 浏览 器 ， 按 图 3-70 所 示 进 行 操 
作 ( 本 例 涉及 的 图 片 在 PyQt5/Chapter03/images 目 录 下 ) 。 
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图 3-70 


首先 进入 资源 编辑 界面 ， 然 后 打开 资源 文件 ， 这 里 打开 上 面 创建 的 
资源 文件 apprcc.qrc。 接 下 来 选中 apprcc.qrc， 设 置 图 片 资源 的 前 缀 为 
pic。 最 后 添加 或 删除 图 片 资源 。 

按照 以 上 步 又 添加 图 片 资 源 后 ， 用 文本 编辑 器 查看 appree.qre X 
件 ， 发 现 它 是 XML 格式 的 。 

< RCC > 
< qresource prefix="pic" > 
< file > images/cartoon1.ico < /file > 
< file > images/cartoon2.ico < /file > 
< file > images/cartoon3.ico < /file > 
< file > images/cartoon4.ico < /file > 
< file > images/python.jpg < /file > 
< /qresource > 
< /RCC > 


3.6.2 在 窗 资源 、 


1. 使 用 Qt Designer 在 窗 体 中 放置 控件 


继续 使 用 Qt Designer 操作 MainWin02.ui 文件 。 在 Qt Designer 窗口 
左 侧 ， 将 Display Widgets 栏 中 的 Label 控 件 拖 到 窗 体 Form 中 间 并 选中 它 ， 
然后 在 Qt Designer 窗 口 右 侧 的 属性 编辑 器 中 找到 pixmap 属 性 ， 单 击 其 后 
面 的 按钮 ， 把 它 的 值 改 为 资源 文件 中 的 一 张 图 片 ， 如 图 3-71 所 示 。 
2. 将 .ui 文件 转换 为 .py 文件 
使 用 pyuic5 命 令 将 .ui 文件 转换 为 .py 文件 。 
pyuic5-o MainWin02.py MainWin02.ui 











图 3-71 


本 例文 件 名 为 PyQt5/Chapter03/MainWin02.py， 其 完整 代码 如 下 : 
from PyQt5 import QtCore,QtGui, QtWidgets 
class Ui_Form(object): 
def setupUi(self,Form): 
Form.setObjectName("Form") 
Form.resize(678,431) 
self. label=QtWidgets.QLabel(Form) 
self.label.setGeometry(QtCore.QRect(80,30,531,321)) 


self.label.setText("") 
self.label.setPixmap(QtGui.QPixmap(":/pic/images/python.jpg")) 
self.label.setObjectName("label") 
self.retranslateUi(Form) 
QtCore.QMetaObject.connectSlotsByName(Form) 
def retranslateUi(self,Form): 
_translate=QtCore.QCoreApplication.translate 
Form.setWindowTitle(_translate("Form","Form")) 
import apprcc_rc 
WAS (58 ei FY AN A BE DS FTE — Ted a O R 
件 CallMain Win02.py， 其 完整 代码 如 下 : 
import sys 
from PyQt5.QtWidgets import QApplication ,QMainWindow 
from MainWin02 import Ui_Form 
class MyMainWindow(QMainWindow, Ui_Form): 
def __init__(self,parent=None): 
super(MyMainWindow,self).___init__(parent) 
self.setup Ui(self) 


W W 


if name ==" main _": 

app=QApplication(sys.argv) 

myWin=MyMainWindow() 

myWin.show() 

sys.exit(app.exec_()) 

运行 ”CallMainWin02.py ”文件 ， 会 抛 出 如 下 异常 信息 ， 提 示 在 
MainWin02.py 中 找 不 到 模块 apprcc_rc。 
Exception "unhandled ImportError" 


No module named ‘apprcec_rc' 


这 说 明 在 脚本 中 使 用 以 下 代码 导入 的 模块 异常 。 
import apprcc_rc 
Val A ASIA Ae REIN — P, mkq MPFR RAN py Ct, PaaS 
入 正常 的 .py 资源 文件 。 


3.6.3 AYA 


使 用 PyQt 5 提供 的 pyrcc5 命令 将 apprcc.qrc 文 件 转换 为 apprcc_rc.py 文 
件 〈 之 所 以 添加 rc， 是 因为 Qt Designer 导入 资源 文件 时 默认 是 加 _rc 
的 ， 这 里 是 为 了 与 Qt Designer 一 致 ) 。 
pyrcc5 apprcc.qrc-o apprcc_rc.py 
转换 完成 后 ， 在 同 级 目录 下 会 多 出 一 个 与 .qrc ”文件 同名 的 .py X 
件 。 查 看 apprcc_rc.py 文 件 ， 其 内 容 如 下 : 





from PyQt5 import QtCore 


qt resource data = b"\ 
\x00\x00\x42\x3e\ 
\x00\x01\x00\x01\x00\x40\x40\x00\x00\x01\x00\x20\x00\x28\x42\x00\ 


# 由 于 代码 较 多 ,此 处 省 略 多 行 代码 
\x£0\x00\x7£\xff£\xff£f\xff\xff£f\xff\xfc\x01\xff£\xff\xff\ 


" 


qt_resource_name = b"\ 
\x00\x03\ 
# 由 于 代码 较 多 ,此 处 省 略 多 行 代码 


\x00\x61\x00\x72\x00\x74\x00\x6f£\x00\x6£\x00\x6e\x00\x32\x00\x2e\x00\ 
x69\x00\x63\x00\x6f\ 


qt _ resource struct = b"\ 
\x00\x00\x00\x00\x00\x02\x00\x00\x00\x01\x00\x00\x00\x01\ 
# 由 于 代码 较 多 ,此 处 省 略 多 行 代码 


\x00\x00\x00\x78\x00\x00\x00\x00\x00\x01\x00\x00\xc6\xc6\ 


" 


def qInitResources(): 
QtCore.qRegisterResourceData(0x01, qt resource struct, 


qt resource name, qt resource data) 


def qCleanupResources(): 
QtCore.qUnregisterResourceData(0x01, qt resource struct, 


qt resource name, qt resource data) 


qiInitResources () 


可 以 看 出 ， 该 文件 已 经 使 用 QtCore.qRegisterResourceData 进行 了 初 
始 化 注册 ， 上 所 以 可 以 直接 引用 该 文件 。 


y 


3.6.4 导入 .py 资源 六 


在 界面 文件 MainWin02.py 中 ， 需 要 使 用 以 下 代码 直接 导入 .py 资源 
有 人 


import apprcc_rc 
Æ Qt Designer 中 使 用 图 片 资源 时 ， 图 片 资源 的 引入 路 径 是 
号 “2 加 网 片 的 路 径 ， 示 例 代 码 如 下 : 
:/pic/images/python.jpg 
注意 到 上 面 的 路 径 与 gre 文件 的 路 径 稍微 有 些 不 同 ， 多 了 一 个 前 
级 “pic”"， 原 因 是 Qt Designer 会 自动 根据 qrc 中 的 qresource 标 签 来 调整 这 个 
路 径 。 如 图 3-72 所 示 ， 在 qresource 标 签 中 有 一 个 “pic” 属 性 ，Qt Designer 
会 自动 把 “pic” 添 加 到 图 片 路 往 images/python.jpg 中 。 


=| apprec. grc 因 B aaaaaa. txt Èd Cal1lNainyin 


1 RCC> 

3 <file>images/cartooni.ico</file> 
<file>images/cartoon2.ico</file> 
<file>images/cartoon3.ico</file> 
<file>images/cartoon4.ico</file> 
<file>images/python.jpg</file> 

</qresource> 
</RCC> 
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图 3-72 apprcc_rc.grc 文 件 


修改 后 的 MainWin02.py 文 件 的 完整 代码 如 下 : 
from PyQt5 import QtCore,QtGui, QtWidgets 
class Ui_Form(object): 
def setupUi(self,Form): 
Form.setObjectName("Form") 
Form.resize(678,431) 
self. label=QtWidgets.QLabel(Form) 


self.label.setGeometry(QtCore.QRect(80,30,531,321)) 
self.label.setText("") 
self.label.setPixmap(QtGui.QPixmap(":/pic/images/python.jpg")) 
self.label.setObjectName("label") 
self.retranslateUi(Form) 
QtCore.QMetaObject.connectSlotsByName(Form) 
def retranslateUi(self,Form): 
_translate=QtCore.QCoreApplication.translate 
Form.setWindowTitle(_translate(""Form","Form")) 
import apprcc_rc 
运行 CallMainWin02.py 文 件 ， 显 示 效 果 如 图 3-73 所 示 。 





图 3-73 


运行 脚本 一 切 正常 ， 可 以 在 窗口 中 看 到 所 导入 的 图 片 资 源 。 


AAR PvQt 5 基本 窗口 控 


任何 理论 的 首要 任务 都 是 阐述 令 人 混淆 的 术语 和 概念 。 只 有 实现 了 
术语 和 概念 的 一 致 性 ， 我 们 才能 够 清晰 、 流 畅 地 思考 问题 ， 并 且 期 望 与 
读者 分 享 相同 的 观点 。 

Shap SEEK, (RS) PER 
同样 的 道理 ， 在 学 习 PyQt 5 之 前 ， 我 们 也 要 对 一 些 令 人 混淆 的 基本 
概念 进行 详细 解释 ， 只 有 彻底 理解 基础 知识 ， 后 面 的 学 习 才 会 更 加 顺 
利 。 这 一 章 我 们 将 关注 PyQt 5 的 基本 窗口 控件 ， 学 会 如 何 部 署 和 调整 控 
件 。 


4.1 QMainWindow 


QMainWindow 主 窗口 为 用 户 提 供 一 个 应 用 程序 框架 ， 它 有 自己 的 
布局 ， 可 以 在 布局 中 添加 控件 。 在 主 窗口 中 可 以 添加 控件 ， 比 如 将 工具 
栏 、 菜 单 栏 和 状态 栏 等 添加 到 布局 管理 器 中 。 








4.1.1 窗口 类 型 介绍 


QMainWindow、QWidget 和 QDialog 三 个 类 都 是 用 来 创建 窗口 的 ， 
可 以 直接 使 用 ， 也 可 以 继承 后 再 使 用 。 

QMainWindow 窗 口 可 以 包含 染 单 栏 、 工 具 栏 、 状 态 栏 、 标 题 栏 
等 ， 是 最 常见 的 窗口 形式 ， 也 可 以 说 是 GUI 程序 的 主 窗口 ， 如 图 4-1 所 
ZN o 





QDialog 是 对 话 框 窗 口 的 基 类 。 对 话 框 主要 用 来 执行 短期 任务 ， 或 
者 与 用 户 进 行 互 动 ， 它 可 以 是 模 态 的 ， 也 可 以 是 非 模 态 的 。QDialog 窗 
口 没有 沫 单 栏 、 工 具 栏 、 状 态 栏 等 ， 如 图 4-2 所 示 。 


® | MainWindow 
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图 4-2 


如 果 是 主 窗口 ， 就 使 用 QMainWindow 类 ; 如 果 是 对 话 框 ， 就 使 用 
QDialog 类 ; 如 采 不 确定 ， 或 者 有 可 能 作为 顶层 窗口 ， 也 有 可 能 艇 入 到 
其 他 窗口 中 ， 那 么 就 使 用 QWidget 类 。 

本 节 只 介绍 QMainWindow 类 ， 关 于 QWidget 类 与 QDialog 类 的 更 详 
细 用 法 会 在 后 续 章 节 中 进行 介绍 ， 读 者 只 需要 对 它们 有 人 简单 的 了 解 就 
行 。 这 些 内 容 都 非常 简单 ， 并 不 需要 进行 太 深入 的 研究 。 


4.1.2 创建 主 窗口 














如 果 一 个 窗口 包含 一 个 或 多 个 窗口 ， 那 么 这 个 窗口 就 是 父 窗口 ， 被 
包含 的 窗口 则 是 子 窗口 。 没 有 父 窗口 的 窗口 是 项 层 窗口 ， 
QMainWindow 就 是 一 个 顶层 窗口 ， 它 可 以 包含 很 多 界面 元 素 ， 如 采 单 
Fe. LRS RAST. FROAS. 

在 PyQt 中 ， 在 主 窗口 (QMainWindow) 中 会 有 一 个 控件 
(QWidget) 占 位 符 来 占 着 中 心 窗 口 ， 可 以 使 用 setCentralWidget0 来 设 
置 中 心 窗口 ， 如 图 4-3 所 示 。 
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图 4-3 


QMainWindow 继 承 自 QWidget 类 ， 拥 有 它 的 所 有 派生 方法 和 属性 。 
QWidget 
| 
+- QMainWindow 
QMainWindow 类 中 比较 重要 的 方法 如 表 4-1 所 示 。 


表 4-1 


返回 主 窗口 的 菜单 栏 
设置 窗口 中 心 的 控件 


获得 状态 栏 对 象 后 , 调用 状态 栏 对 象 的 showMessage(message, int timeout = 0) 方 法 ， 
显示 状态 栏 信息 。 其 中 第 一 个 参数 是 要 显示 的 状态 栏 信息 ; 第 二 个 参数 是 信息 停留 
的 时 间 ， 单 位 是 毫秒 ， 默 认 是 0， 表 示 一 直 显 示 状 态 栏 信息 





QMainWindow 不 能 设置 布局 (使 用 setLayout(0) 方 法 ) , ALN EAA 
己 的 布局 。 
案例 4-1 创建 主 窗口 
本 例文 件 名 为 PyQt5/Chapter04/qt402_QMainWin.py， 演 示 在 PyQt 5 
中 创建 一 个 简单 的 主 窗口 。 其 完整 代码 如 下 : 
import sys 
from PyQt5.QtWidgets import QMainWindow ,QApplication 
from PyQt5.QtGui import QIcon 
class MainWindow(QMainWindow): 
def __init__(self,parent=None): 
super(MainWindow,self).___init__ (parent) 
self.resize(400,200) 
self.status=self.statusBar() 
self.status.showMessage("1X 2 KAS FE FEAR", 5000) 
self.setWindowTitle("PyQt MainWindow 例 子 ") 


TT TT 


if name ==" main _": 
app=QApplication(sys.argv) 
app.setWindowIcon(QIcon("./images/cartoon1.ico")) 
form=MainWindow() 

form.show() 

sys.exit(app.exec_()) 


运行 脚本 ， 显 示 效 果 如 图 4-4 所 示 。 





代码 分 析 : 

self.status.sShowMessage(" 这 是 状态 栏 提示 ",5000) 

使 用 QMainWindow 类 的 statusBar(0) 方 法 创建 状态 栏 ， 然 后 使 用 
showMessage() 方 法 将 提示 信息 显示 在 状态 栏 中 ， 提 示 信 息 的 显示 时 间 
是 5 秒 ，5 秒 后 状态 栏 提示 信息 消失 。 

在 自 定 义 的 窗口 类 MainWindow 中 ， 继 承 了 主 窗口 QMainWindow 
类 所 有 的 属性 和 方法 ， 然 后 使 用 父 类 QMainWindow 的 构造 函数 super() 
初始 化 窗口 ， 再 设置 窗口 标题 ， 最 后 通过 消息 循环 显示 窗口 ， 状 态 栏 可 
以 直接 由 statusBar0 产 生 ， 由 showMessage() 来 显示 信息 。 














4.1.3 将 主 窗口 放 在 屏幕 中 旧 


案例 4-2 主 窗口 居中 显示 
QMainWindow 利用 QDesktopWidget 类 来 实现 主 窗口 居中 显示 。 本 
例文 件 名 为 PyQt5/Chapter04/qt405_center.py， 演 示 在 主 窗口 初始 化 后 ， 
将 它 放 在 屏幕 中 间 。 其 完整 代码 如 下 : 











运行 脚本 ， 显 示 效 果 如 图 4-5 所 示 。 
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图 4-5 


代码 分 析 : 
self.resize(370,250) 
该 行 语句 用 来 设置 QWidget 窗 口 的 大 小 ， 宽 度 为 370 像 素 ， 高 度 为 


250 像 素 。 
screen=QDesktopWidget().screenGeometry() 
该 行 语 句 用 来 计算 显示 屏幕 的 大 小 : 
(screen.width()*screen.height())， 其 中 QDesktopWidget 是 描述 显示 屏幕 的 
类 ， 通 过 QDesktopWidget().screenGeometry() 来 获得 屏幕 的 大 小 。 
size=self.geometry() 
该 行 语 句 用 来 获取 QWidget 窗 口 的 大 小 : 


size.width()) 





(size.width()*size.heiget()). 
/ 2,(screen.height() 


self.move((screen.width()- 


size.height()) / 2) 
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4.1.4 K+ Bo 


案例 4-3 关闭 主 窗口 
本 例文 件 名 为 PyQt5/Chapter04/qt04_closeMainWin.py， 演 示 关 闭 主 
窗口 。 其 完整 代码 如 下 : 





运行 脚本 ， 显 示 效 果 如 图 4-6 所 示 。 





代码 分 析 : 

当 单 击 “ 关 闭 主 窗口 ”按钮 后 ， 将 关闭 显示 的 窗口 。 通 过 以 下 代码 将 
按钮 的 dicked 信 号 与 onButtonClick 槽 函数 关联 起 来 。 

self.button1.clicked.connect(self.onButtonClick) 

在 横 函 数 onButtonClick() 里 获得 QApplication 类 的 对 象 ， 调 用 它 的 
quit() 函 数 来 关闭 窗口 ， 在 柳 函 数 里 还 可 以 获得 发 送信 号 的 对 象 ， 在 本 
例 中 发 送信 号 对 象 是 名 字 为 “关闭 主 窗口 ”的 按钮 控件 ， 然 后 就 可 以 通过 
按钮 的 text() 函 数 获得 按钮 的 显示 名 称 。 

def onButtonClick(self ): 
# sender 是 发 送信 号 的 对 象 ， 此 处 发 送信 号 的 对 象 是 button1 按 























钮 


sender=self.sender() 
print( sender.text() + ' 被 按 下 了 ') 
qApp=QApplication.instance() 


qApp.quit() 


4.2 QWidget 


基础 窗口 控件 QWidget 类 是 所 有 用 户 界 面 对 象 的 基 类 ， 所 有 的 窗口 
和 控件 都 直接 或 间接 继承 自 QWidget 类 。 

窗口 控件 (Widget， 简 称 “ 控 件 ”*”) 是 在 PyQt 中 建立 界面 的 主要 元 
素 。 在 PyQt 中 把 没有 艇 入 到 其 他 控件 中 的 控件 称 为 窗口 ， 一 般 窗口 都 有 
边框 、 标 题 栏 。 窗 口 是 指 程序 的 整体 界面 ， 可 以 包含 标题 栏 、 荣 单 栏 、 
工具 栏 、 关 闭 按钮 、 最 小 化 按钮 、 最 大 化 按钮 等 ， 控 件 是 指 按钮 、 复 选 
框 、 文 本 框 、 表 格 、 进 度 条 等 这 些 组 成 程序 的 基本 元 素 。 一 个 程序 可 以 
有 多 个 窗口 ， 一 个 窗口 也 可 以 有 多 个 控件 。 


4.2.1 窗口 坐标 系统 


PyQt ”使 用 统一 的 坐标 系统 来 定位 窗口 控件 的 位 置 和 大 小 。 具 体 的 
坐标 系统 如 图 4-7 所 示 。 
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图 4-7 


以 屏幕 的 左上 角 为 原点 ， 即 (0,0) 点 ， 从 左 同 右 为 x 轴 正 同 ， 从 上 同 
下 为 y 轴 正 同 ， 整 个 屏 磊 的 坐标 系统 就 用 来 定位 顶层 窗口 的 。 

此 外 ， 在 窗口 内 部 也 有 自己 的 坐标 系统 ， 该 坐标 系统 仍然 以 左上 角 
作为 原点 ， 从 左 同 右 为 x 轴 正 辐 ， 从 上 同 下 为 y 轴 正 同 ， 原 点 、x 轴 、y 轴 
围 成 的 区 域 叫 作 Client Area (客户 区 ) ， 在 客户 区 的 周围 则 是 标题 栏 
(Window Title) 和 边框 (Frame) 。 

如 图 4-8 所 示 是 Qt 提供 的 分 析 QWidget 几何 结构 的 一 张 图 ， 在 帮 
助 文档 的 “Window and Dialog Widgets” 中 可 以 找到 相关 的 内 容 介绍 。 
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图 4-8 


从 图 4-8 可 以 看 出 ， 这 些 成 员 函 数 分 为 三 类 。 

QWidget 直 接 提 供 的 成 员 函 数 : x0、yO 获 得 窗口 左上 角 的 坐标 ， 
width()、height() 获 得 客户 区 的 宽度 和 高 度 。 

QWidget 的 geometry0) 提 供 的 成 员 函 数 : x()、y0 获 得 客户 区 左上 角 
的 坐标 ，width()、height() 获 得 客户 区 的 宽度 和 高 度 。 

QWidget 的 frameGeometry0) 提 供 的 成 员 函 数 : x()、y0 获 得 窗口 左上 
角 的 坐标 ，width()、height() 获 得 包含 客户 区 、 标 题 栏 和 边框 在 内 的 整个 
窗口 的 宽度 和 高 度 。 











4.2.2 名 用 的 几何 机 校 


从 图 4-8 可 以 看 出 ，QWidget 有 两 种 常用 的 几何 结构 。 
不 包含 外 边 各 种 边框 的 几何 结构 。 
包含 外 边 各 种 边框 的 几何 结构 。 
1.QWidget 不 包含 边框 的 常用 函数 
一 般 情 况 下 ， 不 包含 边框 的 部 分 是 客户 区 ， 这 里 面 束 是 我 们 正常 操 
作 的 地 方 ， 可 以 添加 子 控件 。 这 部 分 是 一 个 长 方形 ， 会 有 大 小 和 位 置 。 
大 小 就 是 指 宽度 (width) 和 高 度 eigh) ; 位 置 就 是 指 这 个 长 方形 在 
屏 硕 上 的 位 置 。 在 Qt 中 保存 这 个 长 方形 使 用 的 是 QRect 类 ， 这 个 类 也 有 
自己 的 大 小 和 位 置 。 要 改变 其 大 小 和 位 置 ， 可 以 使 用 如 下 几 个 函数 。 
D 改变 客户 区 的 面积 
QWidget.resize(width,height) 
QWidget.resize(QSize ) 
这 两 个 图 数 改 变 了 长 方形 的 大 小 ， 其 中 第 一 个 参数 是 宽度 ， 第 二 个 
参数 是 高 度 。 设 置 了 大 小 的 窗口 ， 还 可 以 用 鼠标 来 改变 它 的 大 小 。 
(2) 获得 客户 区 的 大 小 
QWidget.size() 
(3) 获得 客户 区 的 宽度 和 高 度 
QWidget.width() 
QWidget.height() 
(4) 设置 客户 区 的 宽度 和 蜗 度 
QWidget.setFixedWidth(int width) 
使 用 这 个 函数 ， 客 户 区 的 高 度 就 是 固定 的 ， 不 可 以 改变 ， 只 可 以 改 











QWidget.setFixedHeight(int height) 

这 时 候 宽 度 就 是 固定 的 ， 不 可 以 改变 ， 但 是 可 以 改变 高 度 
QWidget.setFixedSize(QSize size) 
QWidget.setFixedSize(int width,int height) 








通过 上 面 这 两 个 函数 ， 高 度 和 宽度 都 是 固定 的 ， 不 可 以 通过 鼠标 来 
改变 窗口 的 宽度 和 高 度 。 如 果 要 同时 改变 客户 区 的 大 小 和 位 置 ， 需 要 用 
到 以 下 函数 。 

QWidget.setGeometry(int x,int y,int width,int height); 
QWidget.setGeometry( QRect rect) 

X 和 y 对 应 的 就 是 x 和 y 坐 标 。 可 以 不 单独 设置 x 和 y 坐 标 。 

2.QWidget 包 含 边 框 的 常用 函数 

QWidget 包 含 边框 ， 这 个 边框 有 大 小 和 位 置 ， 是 窗口 在 屏 磋 上 显示 
的 整个 区 域 。 

这 里 没有 设置 这 个 边框 大 小 的 函数 ， 因 为 通过 上 面 不 包含 边框 函数 
的 设置 ， 就 可 以 设置 包含 边框 的 大 小 了 。 通 过 下 面 的 函数 ， 可 以 获得 整 
个 窗口 的 位 置 和 大 小 。 

(1) 获得 窗口 的 大 小 和 位 置 

QWidget.frameGeometry() 

(2) 设置 窗口 的 位 置 

QWidget.move(int x,int y) 





QWidget.move(QPoint point ) 
(3) 获得 窗口 左上 角 的 坐标 
QWidget.pos() 





案例 4-4 屏幕 坐标 系统 显示 
本 例文 件 名 为 ”PyQt5/Chapter04/qt401_widgetGeometry.py， 演 示 在 
PyQt 5 中 QWidget 控 件 在 屏幕 上 的 坐标 系统 。 其 完整 代码 如 下 : 


from PyQt5.QtWidgets import QApplication, QWidget, QPushButton 


import sys 


app = QApplication(sys.argv) 
widget = QWidget () 

btn = QPushButton( widget ) 
btn.setText ("Button") 

# 以 QWidget ALMA (0, 0).% 


btn.move(20, 20) 

# 不 同 的 操作 系统 可 能 对 窗口 的 最 小 宽度 有 规定 ， 若 设置 宽度 小 于 规定 值 ， 则 会 以 规定 值 进行 显示 
widget.resize(300, 200) 

# 以 屏幕 左上 角 为 (0，0) 点 

widget.move (250, 200) 


widget.setWindowTitle ('PyQt 坐标 系统 例子 ') 
widget .show() 

print ("QWidget:") 

print ("w.x()=%d" % widget.x() ) 

print ("w.y()=%sd" % widget.y() ) 

print ("w.width()=%d" % widget.width() ) 
print ("w. height ()=%d" % widget.height() ) 
print ("QWidget.geometry") 


Q 


print ("widget.geometry().x()=%d" % widget.geometry().x() ) 
print ("widget.geometry().y()=sd" % widget.geometry().y() ) 
print ("widget.geometry() .width()=sd" % widget.geometry().width() ) 


Q 


print ("widget.geometry ().height ()=%d" % widget.geometry().height() ) 


sys.exit(app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 4-9 所 示 。 
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图 4-9 


4.2.3 创建 第 一 个 PyQt 5 应 用 





下 面 的 示例 代码 非常 简单 ， 只 是 显示 一 个 小 窗口 。 可 以 对 窗口 进行 
操作 ， 比 如 修改 它 的 大 小 、 最 大 化 、 最 小 化 等 。 在 很 多 程序 中 都 需要 进 
行 这 些 操作 ，PyQt 已 经 号 好 了 这 些 操作 的 代码 ， 我 们 只 需要 引入 封装 好 
的 代码 就 可 以 了 。 这 些 代 码 对 程序 员 来 说 是 隐藏 的 。PyQt ”就 是 一 个 抽 
象 的 工具 包 ， 如 果 使 用 底层 的 工具 包 (Win32 MFC) 来 实现 相同 的 功 
能 ， 这 个 示例 代码 就 会 增加 很 多 。 

案例 4-5 建立 一 个 主 窗口 
本 例文 件 名 为 PyQt5/Chapter04/qt402_FirstPyQt.py， 演 示 在 PyQt 5 中 
建立 一 个 主 窗 口 。 其 完整 代码 如 下 : 
-*- coding: UTF-8-* 
import sys 
from PyQt5.QtWidgets import QApplication,QWidget 








app=QApplication(sys.argv) 
window=QWidget() 
window.resize(300,200) 
window.move(250,150) 
window.setWindowTitle(‘Hello PyQt5') 
window.show() 
sys.exit(app.exec_()) 

运行 脚本 ， 显 示 效 果 如 图 4-10 所 示 。 


图 4-10 


代码 分 析 : 

#-*- coding: UTF-8-* 

这 行 代码 是 为 了 避免 在 所 生成 的 PyQt 程序 中 出 现 中 文 乱码 问题 。 

什么 是 UTF-8? 

UTF-8 (8-bit Unicode Transformation Format) 是 一 种 针对 Unicode 
的 可 变 长 度 字 符 编 码 ， 又 称 “ 万 国 码 ” 由 Ken Thompson 于 1992 年 创建 ， 
现在 已 经 标准 化 为 RFC ”3629。UTF-8 用 1~4 个 字 节 编码 Unicode 字 符 ， 
用 在 网 页 上 可 以 统一 页 面 显 示 中 文 简体 /楷体 及 其 他 语言 《如 英文 、 日 
文 、 韩 文 ) 。 提 倡 使 用 UTF-8 编 码 方案 ， 这 样 PyQt 程 序 就 可 以 在 多 个 平 














台 〈 如 Windows、Linux 等 ) 下 正常 显示 中 文 了 。 
import sys 
from PyQt5.QtWidgets import QApplication,QWidget 

这 两 行 代码 用 来 载 入 必需 的 模块 。 在 Qt5 中 使 用 的 基本 的 GUI 窗 
口 控件 都 在 PyQt5.QtWidgets 模 块 中 。 

app=QApplication(sys.argv) 

每 一 个 PyQt5 程序 都 需要 有 一 个 QApplication 对 象 ，QApplication 
类 包含 在 QTWidgets 模 块 中 。sys.argv 是 一 个 命令 行 参数 列表 。Python 脚 
本 可 以 从 Shell 中 执行 ， 比 如 双击 ”.py 脚 本 文件 ， 通 过 参数 来 选择 启动 脚 
本 的 方式 。 

window=QWidget() 

QWidget 控件 是 PyQt5 中 所 有 用 户 界 面 类 的 父 类 。 这 里 使 用 了 没有 
参数 的 默认 构造 函数 ， 它 没有 继承 其 他 类 。 我 们 称 没有 父 类 的 控件 为 窗 
Oo 

需要 注意 的 是 ， 窗 口 和 控件 都 继承 自 QWidget 类 ， 如 果 不 为 控件 指 
定 一 个 父 对 象 ， 那 么 该 控件 就 会 被 当 作 窗 口 处 理 ， 这 时 
setWindowTitle() 和 setWindowlIcon() 函数 就 会 生效 。 

window.resize(300,200) 

使 用 resize() 方 法 可 以 改变 窗口 控件 的 大 小 ， 在 这 里 设置 窗口 的 宽度 
KIORE. HHI PE A 2OOR AE © 

window.move(250, 150) 

使 用 move() 方 法 可 以 设置 窗口 初始 化 的 位 置 (x,y)。 

窗口 的 坐标 系统 就 像 手机 屏 硕 一 样 ， 在 iOS、Android 和 Windows 
Phone 的 UI 坐标 布局 中 : 

坐标 系统 在 屏幕 左上 角 ，(0,0) 为 原点 。 

X 是 从 左 到 右 递增 的 。 

y 是 从 上 到 下 递增 的 。 











显示 效果 如 图 4-11 所 示 。 





图 4-11 


window.setWindowTitle('Hello PyQt5') 
这 行 代码 用 来 设置 窗口 控件 的 标题 ， 该 标题 将 在 窗口 的 标题 栏 中 显 


window.show() 

使 用 show() 方 法 将 窗口 控件 显示 在 屏幕 上 。 

sys.exit(app.exec_()) 

最 后 进入 该 程序 的 主 循环 。 事 件 处 理 从 本 行 代码 开始 ， 主 循环 接收 
事件 消息 并 将 其 分 发 给 程序 的 各 个 控件 。 如 果 调 用 “exit0 或 主 控件 被 销 
毁 ， 主 循环 就 会 结束 。 使 用 ”sys.exit(0 方 法 退出 可 以 确保 程序 完整 地 结 
束 ， 在 这 种 情况 下 系统 的 环境 变量 会 记录 程序 是 如 何 退出 的 。 

如 果 程 序 运行 成 功 ， 那 么 exec_0 的 返回 值 为 0， 否 则 为 非 0。 

















为 什么 程序 主 函数 的 返回 值 为 0? 

无 论 是 C 还 是 C++， 从 main 函 数 返 回 的 结果 都 相当 于 调用 了 exit 函 
数 ，main 的 返回 值 会 作为 传 给 exit 函 数 的 参数 。 

exit 对 参数 的 说 明 如 下 : 

e 如 果 参 数 为 0 或 EXIT_SUCCESS， 则 向 外 部 环境 报告 程序 运行 圆 





满 结 束 。 

e 如 果 参 数 为 EXIT_FAILURE， 则 向 外 部 环境 报告 程序 运行 以 失败 
He OB 
AA 


e 如 果 参 数 为 其 他 值 ， 则 结果 由 实现 定义 。 

所 以 ，return 0 是 有 确定 语义 的 返回 方式 ， 而 return 1 则 不 具备 可 移 
植 性 。PyQt 5 的 底层 使 用 的 就 是 C++， 所 以 不 难 理解 为 什么 主 函 数 执行 
成 功 后 exec_0) 的 返回 值 为 0 了 。 

有 关 exec_0 的 下 画 线 问题 解释 如 下 : 

QApplication 类 的 exec_0) 函 数 来 自 于 PyQt 4 及 以 前 版 本 ， 因 为 在 
Python 2 中 ，exec 是 Python 的 关键 字 ， 为 避免 冲突 ，PyQt 5 使 用 了 exec_( 
这 个 名 称 。 这 个 问题 在 Python ”3 中 己 经 解决 ， 所 以 如 果 你 的 代码 只 在 
Python 3 下 运行 ， 那 么 完全 可 以 写成 : 

app.exec() 

当然 ， 为 了 保持 同 后 兼容 ， 带 有 下 男 线 的 函数 还 是 可 以 使 用 的 ， 在 

本 书后 面 的 代码 中 将 保持 这 种 风格 。 


4.2.4 为 应 用 设置 程序 图 标 


上 一 节 中 我 们 学 习 了 如 何 创建 一 个 最 简单 的 PyQt 5 应 用 ， 在 这 一 节 
中 将 介绍 如 何 为 PyQt 5 应 用 添加 个 性 化 图 标 。 

程序 图 标 就 是 一 个 小 图 片 ， 通 种 显示 在 标题 栏 的 左上 角 。 本 书 中 所 
有 PyQt 应 用 使 用 的 图 标 ， 都 是 从 easyicon 网 站 











(http://www.easyicon.net/) 免费 下 载 的 。easyicon 网 站 提供 了 超过 50 万 
个 PNG、ICO、ICNS 格 式 的 图 标 搜索 、 图 标 下 载 服务 ， 可 以 免费 使 用 。 


案例 4-6 设置 程 未 


本 例文 件 名 为 PyQt5/Chapter04/qt403_QIcon.py， 演 示 为 PyQt 5 应 用 
设置 程序 图 标 。 其 完整 代码 如 下 : 


import sys 
from PyQt5.QtGui import QIcon 
from PyOt5.QtWidgets import QWidget , QApplication 


#1 创建 一 个 名 为 Tcon 的 窗口 类 ， 继 承 自 QWidget 类 
class Icon (QWidget): 
def init (self, parent = None): 
super(Icon,self). init (parent) 
self.initUI () 


#2 初始 化 窗口 

def initUI (self): 
self.setGeometry(300, 300, 250, 150) 
self.setWindowTitle(' 程 序 图 标 ') 


self.setWindowIcon (QIcon('./images/cartoonl.ico')) 


if _ name == | main ': 


app = QApplication(sys.argv) 
icon = Icon() 


icon.show() 


sys.exit (app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 4-12 所 示 。 


图 4-12 


第 一 个 PyQt 5 应 用 示例 代码 是 采用 面 癌 过 程 的 风格 编写 的 ， 而 这 个 
应 用 示例 代码 采用 的 是 面 癌 对象 的 风格 ，Python 同 时 文 持 面 问 过 程 和 面 
同 对 象 编程 。PyQt 编 程 的 精明 是 面 和 名 对象 编 程 ， 这 意味 着 在 随后 的 开发 
中 将 转 同 面 同 对 象 的 编程 风格 。 

在 面 同 对 象 编程 中 最 重要 的 是 类 、 属 性 和 方法 。 在 第 1 组 代码 中 ， 
创建 了 一 个 名 为 Icon 的 新 类 ， 该 类 继承 自 QWidget 类 ， 因 此 必须 调用 两 
个 构造 函数 一 一 Icon 的 构造 函数 和 继承 类 QWidget 的 构造 亢 数 。 

在 第 2 组 代码 中 ， 定 义 了 初始 化 界面 方法 initUI()， 使 用 QWidget 类 
的 setGeometry() 方 法 完成 了 两 个 功能 一 一 设置 窗口 在 屏幕 上 的 位 置 和 设 
置 窗口 本 号 的 大 小 。 它 的 前 两 个 参数 是 窗口 在 屏幕 上 的 x 和 y 坐 标 ; 后 两 
个 参数 是 窗口 本 里 的 宽度 和 高 度 

使 用 setWindowIcon() 方 法 来 设置 程序 图 标 ， 它 需要 一 个 QIcon 类 型 
的 对 象 作 为 参数 。 在 调用 QIcon 构 造 函数 时 ， 我 们 需要 提供 图 标 路 径 

(相对 路 径 或 绝对 路 径 ) 。 同 时 注意 ， 使 用 QIcon 类 型 必须 导入 此 模 
ER: from PyQt5.QtGui import QIcon. 























— fs 一 ps 
4.2.5 显示 BOR =E 





在 设计 界面 时 应 尽 可 能 人 性 化 ， 对 于 关键 的 操作 ， 给 出 相关 信息 的 
提示 会 非常 有 用 。 本 例文 件 名 为 PyQt5/Chapter04/qt404_QToolTip.py， 


演示 在 PyQt 5 的 窗口 控件 中 设置 一 个 气泡 提示 。 其 完整 代码 如 下 : 


import sys 
from PyOt5.QtWidgets import QWidget, QToolTip , QApplication 
from PyQt5.QtGui import QFont 


class Winform(QWidget) : 
dee amit (serf); 
Superi- _ anit () 
ME ra ue 


def initUI (self): 
QToolTip.setFont (QFont ('SansSerif', 10)) 
self.setToolTip(' 这 是 一 个 <b> 和 气泡 提示 </b>') 
self.setGeometry(200, 300, 400, 400) 
self.setWindowTitle(' 气 泡 提 示 demo') 


nn 
app = QApplication(sys.argv) 
win = Winform () 
win.show() 


sys.exit(app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 4-13 所 示 。 








图 4-13 


代码 分 析 : 
在 本 例 中 ， 我 们 为 一 个 QWidget 类 型 的 窗口 控件 设置 气泡 提示 。 
self.setToolTip( 这 是 一 个 <b > 气泡 提示 < /b > ') 
要 创建 工具 提示 ， 则 需要 调用 setToolTip() 方 法 ， 该 方法 接受 富 文本 
格式 的 参数 。 
QToolTip.setFont(QFont(‘SansSerif’,10)) 
通过 此 行 语句 设置 气泡 提示 信息 的 字体 与 字号 大 小 。 








4.3 QLabel 





QLabel 对 象 作 为 一 个 占 位 符 可 以 显示 不 可 编辑 的 文本 或 图 乒 ， 也 可 
以 放置 一 个 GIF 动画 ， 还 可 以 被 用 作 提 示 标 记 为 其 他 控件 。 纯 文本 、 链 
接 或 语文 本 可 以 显示 在 标签 上 。 

QLabel 是 界面 中 的 标签 类 ， 它 继承 自 QFrame 类 。QLabel 类 的 继承 
结构 如 下 : 





QObject -===-= + 


QPaintDevice --| 
| 
(Woe 
| 
+———— OFrame 
| 
ta- Oliabel 





QlabeL 类 中 的 第 用 方法 如 表 4-2 所 示 。 





表 4-2 


setAlignment() 按 固 定 值 方式 对 齐 文本 : 
© Qt.AlignLeft， 水 平方 向 靠 左 对 齐 
。 Qt.AlignRight， 水 平方 向 靠 右 对 齐 
© Qt.AlignCenter， 水 平方 向 居中 对 齐 
© Qt.AlignJustify， 水 平方 向 调整 间距 两 端 对 齐 
。 QtLAlignTop， 垂 直方 向 靠 上 对 齐 
。 QtLAlignBottom， 垂 直方 向 靠 下 对 齐 
。 QtLAlignVCenter， 垂 直方 向 居中 对 齐 


setPixmap() 设置 QLabel 为 一 个 Pixmap [| 
获得 QLabel 的 文本 内 容 
设置 QLabel 的 文本 内 容 
返回 所 选择 的 字符 


setBuddy() 设置 QLabel 的 助 记 符 及 buddy〔 伙 伴 )， 即 使 用 QLabel 设置 快捷 键 ， 会 在 快捷 键 后 将 焦 
点 设置 到 其 buddy 上 ， 这 里 用 到 了 QLabel 的 交互 控件 功能 。 此 外 ，buddy 可 以 是 任何 一 
个 Widget 控件 。 使 用 setBuddy(QWidget *) 设 置 ， 其 QLabel 必须 是 文本 内 容 ， 并 且 使 用 
“有 ”符号 设置 了 助 记 符 


设置 是 否 允 许 换行 
QLabel 类 中 的 第 用 信号 如 表 4-3 所 示 。 


表 4-3 











linkActivated 当 单 击 标签 中 典 入 的 超 链接 ， 和 希望 在 新 窗口 中 打开 这 个 超 链 接 时 ，setOpenExternalLinks 


特性 必须 设置 为 true 


当 鼠 标 指针 滑 过 标签 中 工 入 的 超 链 接 时 ， 和 需要 用 槽 函数 与 这 个 信号 进行 绑 定 
= 
案例 4-7 显示 QLabel 标 签 





本 例文 件 名 为 PyQt5/Chapter04/qt0406_QLabel.py， 演 示 在 PyQt 5 的 
窗口 中 显示 QLabel 标 签 。 其 完整 代码 如 下 : 


from PyOt5.QtWidgets import QApplication, QLabel ,QWidget, OQVBoxLayout 
from PyQt5.QtCore import Qt 

from PyQt5.QtGui import QPixmap ,QPalette 

import sys 


class WindowDemo (QWidget) : 
def Init (selfs 
SUPEE imit IG) 


labell = QLabel (self) 


label2 = QLabel (self) 
label3 = QLabel (self) 
label4 = QLabel (self) 


#1 初始 化 标签 控件 

labell.setText ("这 是 一 个 文本 标签 。") 
labell.setAutoFillBackground (True) 
palette = QPalette() 

palette.setColor (QPalette.Window, Ot.blue) 
labell.setPalette (palette) 
labell.setAlignment( Qt.AlignCenter) 


label2.setText ("<a href='# > 欢迎 使 用 Python GUI 应 用 </a>") 


label3.setAlignment( Qt.AlignCenter) 
label3.setToolTip(' 这 是 一 个 图 片 标签 ' ) 


label3.setPixmap( QPixmap("./images/python.jpg") ) 


label4.setText ("<A href="http://www.cnblogs.com/wangshuol/'>%x 
迎 访 问 信 平 的 小 屋 </a>") 

label4.setAlignment( Qt.AlignRight) 

label4.setToolTip(' 这 是 一 个 超 链 接 标 签 ') 


#2 在 窗口 布局 中 添加 控件 
vbox=QVBoxLayout () 
vbox.addWidget (label1l) 
vbox.addStretch () 
vbox.addWidget (label2) 
vbox.addStretch () 


vbox.addWidget( label3 ) 
vbox.addStretch () 
vbox.addWidget ( label4) 


#3 允许 labell 控件 访问 超 链接 

labell.setOpenExternalLinks (True) 

# 打开 允许 访问 超 链 接 ,默认 是 不 允许 ,需要 使 用 setOpenExternalLinks (True) 
允许 浏览 器 访问 超 链接 

label4.setOpenExternalLinks( False ) 

# Sd LATE AGS 

label4.linkActivated.connect( link clicked ) 


# Tit LAE SASH 
label2.linkHovered.connect( link hovered ) 
labell.setTextInteractionFlags( Ot.TextSelectableByMouse ) 


self.setLayout (vbox) 
self.setWindowTitle("QLabel 例子 ") 


def link hovered(): 
print (" 当 和 鼠标 滑 过 label-2 标签 时 ， 触 发 事件 。") 


def link clicked): 
print (" 当 用 鼠标 点 击 label-4 标签 时 ， 触 发 事件 。" ) 


if _ name == " main ": 
app = QApplication(sys.argv) 
win = WindowDemo () 
win.show() 
Ssys.exit(app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 4-14 所 示 。 


欢迎 使 用 Python GUI 应 用 





图 4-14 


代码 分 析 : 
(1) 设置 文本 标签 居中 显示 。 
labell.setAlignment( Qt.AlignCenter) 
(2) 打开 外 部 链接 
在 这 个 例子 中 ，QLabel 对 象 label2 和 label4 包含 超 链 接 的 标题 。 
label4 的 letOpenExternalLinks 被 设置 为 True， 因此， 如果 点 击 这 个 标 
签 ， 则 相关 的 URL 将 在 浏览 器 中 打开 。 将 label4 的 linkHovered 信 号 连接 
到 link_clicked 0 函数 ， 所 以 ， 当 用 鼠标 点 击 它 时 ， 这 个 函数 将 被 执行 。 
label4=QLabel(self) 
label4.setOpenExternalLinks( True ) 





label4.setText(" < A href="http://www.cnblogs.com/wangshuol/" > Xx 
迎 访 问 信 平 的 小 屋 < /a > ") 


label4.linkActivated.connect( link_clicked ) 
案例 4-8 QLabel 标 签 快捷 键 比 


本 例文 件 名 为 PyQt5/Chapter04/qt0407_QLabel.py， 演 示 在 PyQt 5 的 
窗口 中 使 用 QLabel 标 签 的 快捷 键 。 其 完整 代码 如 下 : 


from PyQt5.0tWidgets import * 


import sys 


class QlabelDemo(QDialog): 
def init (self ): 


superin Imite O 


self.setWindowTitle ('QLabel 例子 ') 
nameLb1 = QLabel('&Name', self) 
nameEd1 = QLineFdit( self ) 
nameLb1.setBuddy (nameEd1) 


nameLb2 = QLabel('&Password', self) 
nameEd2 = QLineEdit( self ) 
nameLb2.setBuddy (nameEd2) 


btnOk = QPushButton ('&OK') 
btnCancel = QPushButton('&Cancel') 
mainLayout = QGridLayout (self) 
mainLayout.addWidget (nameLb1, 0,0) 


mainLayout.addWidget (nameEd1,0,1,1,2) 


mainLayout.addWidget (nameLb2,1,0) 
mainLayout.addWidget (nameEd2,1,1,1,2) 


mainLayout.addWidget (btnOk, 2,1) 
mainLayout.addWidget (btnCancel, 2,2) 


def link hovered(): 
print (" 当 饼 标 滑 过 label-2 标签 时 ， 触 发 事件 。") 


def link clicked(): 
print ("SA RMAF label-4 标签 时 ， 触 发 事件 。" ) 


if name == " main ™: 
app = QApplication(sys.argv) 
labelDemo = QlabelDemo () 
labelDemo. show () 


SYS.exit(app.exec. ())) 


运行 脚本 ， 显 示 效 果 如 图 4-15 所 示 。 





Name 








Password 








图 4-15 


在 弹出 的 窗口 中 ， 按 “Alt+N” 快 捷 键 可 以 切换 到 第 一 个 文本 框 ， 因 
为 这 个 文本 框 已 经 与 QLabel 进 行 了 关联 。QLabel 组 件 也 设置 了 快捷 方 
式 '&Name'， 代 人 码 如 下 : 
nameLb1=QLabel('&Name',self) 
nameEd1=QLineEdit( self ) 


nameLb1.setBuddy(nameEd1) 


X 


4.4 EZ HS 


4.4.1 QLineEFdit 


QLineEdit 类 是 一 个 单行 文本 框 控 件 ， 可 以 输入 单行 字符 串 。 如 果 
需要 输入 多 行 字符 串 ， 则 使 用 QTextEdit 类 。 
QLineEdit 类 中 的 常用 方法 如 表 4-4 所 示 。 





表 4-4 





setA lignment() 按 固 定 值 方式 对 齐 文本 : 

© QLAlignLef， 水 平方 向 靠 左 对 齐 

。 Qt.AlignRight， 水 平方 向 靠 右 对 齐 

© Qt.AlignCenter， 水 平方 向 居中 对 齐 

。Qt.AlignJustify， 水 平方 向 调整 间距 两 端 对 齐 

。 Qt.AlignTop， 重 直方 向 靠 上 对 齐 

è QtAlignBottom， 重 直方 向 靠 下 对 齐 

。 QLAlignVCenter， 重 直方 向 居中 对 章 

清除 文本 框 内 容 

设置 文本 框 显 示 格 式 。 人 允许 输入 的 文本 显示 格式 的 值 可 以 是 : 

。 QLineEdit.Normal， 正 常 显示 所 输入 的 字符 ， 此 为 拓 认 选项 

© QLineEdit.NoEcho, 不 显示 任何 输入 的 字符 ， 常 用 于 密码 类 型 的 输入 ， 且 . 
其 密码 长 度 需要 保密 时 

。 QLineEdit.Password， 显 示 与 平台 相关 的 密码 掩 码 字 符 ， 而 不 是 实际 输入 
的 字符 

è QLineEdit.PasswordEchoOnEdit， 在 编辑 时 显示 字符 ， 负 责 显示 密码 类 型 
的 输入 

设置 文本 框 浮 显 文字 

设置 文本 框 所 允许 输入 的 最 大 字符 数 

设置 文本 框 为 只 读 的 

设置 文本 框 内 容 

设置 文本 框 是 否 接受 拖 动 

设置 允许 输入 字符 的 最 大 长 度 

设置 文本 框 的 验证 器 〈 验 证 规则 )， 将 限制 任意 可 能 输入 的 文本 。 可 用 的 校 

验 器 为 : 

。 QIntValidator， 限 制 输 入 整数 

© QDoubleValidator， 限 制 输 入 浮 点 数 

。 QRegexpValidator， 检 查 输入 是 否 符 合 正 则 表达 式 


定义 输入 掩 码 的 字符 ， 表 4-5 中 列 出 了 输入 掩 码 的 占 位 符 和 字面 字 
人 符 ， 并 说 明 其 如 何 控 制 数 据 输入 。 





表 4-5 


ASCI 字母 字符 是 必须 输入 的 “A~Z、a~z) 

ASCII 字母 字符 是 允许 输入 的 ， 但 不 是 必需 的 

ASCI 字母 字符 是 必须 输入 的 (A~Z、a~z、0~9) 
ASCII 字母 字符 是 允许 输入 的 ， 但 不 是 必需 的 

任何 字符 都 是 必须 输入 的 

任何 字符 都 是 允许 输入 的 ， 但 不 是 必需 的 

ASCH 数字 字符 是 必须 输入 的 (0~9) 

ASCII 数字 字符 是 允许 输入 的 ， 但 不 是 必需 的 

ASCI 数字 字符 是 必须 输入 的 〈1-9) 

ASCH 数字 字符 是 允许 输入 的 ， 但 不 是 必需 的 〈 1~9) 
ASCI 数字 字符 或 加 / 减 符 号 是 允许 输入 的 ， 但 不 是 必需 的 
十 六 进 制 格式 字符 是 必须 输入 的 (A~F、a~f、0-~9) 
十 六 进 制 格式 字符 是 允许 输入 的 ， 但 不 是 必需 的 

二 进 制 格式 字符 是 必须 输入 的 〈0, 1) 

二 进 制 格式 字符 是 允许 输入 的 ， 但 不 是 必需 的 

所 有 的 字母 字符 都 大 写 

所 有 的 字母 字符 都 小 写 

关闭 大 小 写 转换 

使 用 “\ ” 转 义 上 面 列 出 的 字符 


掩 码 由 掩 码 字符 和 分 隔 符 字符 串 组 成 ， 后 面 可 以 跟 一 个 分 号 和 空白 
字符 ， 空 白字 符 在 编辑 后 会 从 文本 中 删除 的 。 掩 码 示 例如 表 4-6 所 示 。 

















表 4-6 


000.000.000.000;_ IP 地 址 ， 空 白字 符 是 “_” 
HH:HH:HH:HH:HH:HH; MAC 地 址 


0000-00-00 日 期 ， 空 白字 符 是 空格 
>AAAAA-AAAAA-AAAAA-AAAAA-AAAAA:# | 许可 证 号 ， 空 白字 符 是 “-” 所 有 字母 字符 转换 为 大 写 


QLineEdit 类 中 的 常用 信号 如 表 4-7 所 示 。 


表 4-7 





selectionChanged 要 选择 改变 了 ， 这 个 信号 就 会 被 发 射 


textChanged 当 修 改 文本 内 容 时 ， 这 个 信号 会 被 发 射 


editingFinished 当 编 辑 文本 结束 时 ， 这 个 信和 号 会 被 发 射 
案例 4-9 EchoModet{)] {i 7s % 
本 例文 件 名 为 PyQt5/Chapter04/qt04_lineEdit01.py， 其 完整 代码 如 





Pi 


from PyQt5.QtWidgets import QApplication, QLineEdit , QWidget , 


OFormLayout 


import sys 


class lineEditDemo (QWidget): 
def init (self, parent=None): 


åf _ name 


app 


super(lineEditDemo, Self). init (parent) 
self.setWindowTitle ("QLineEdit 例子 ") 


flo 


= QFormLayout () 


pNormalLineEdit = QLineEdit( ) 
pNoEchoLineEdit = QLineEdit () 
pPasswordLineEdit = QLineEdit( ) 
pPasswordEchoOnEditLineEdit = QLineEdit( ) 


EVO. 
ELOR 
Elo. 
ELO: 


addRow("Normal", pNormalLineEdit) 

addRow ("NoEcho", pNoEchoLineEdit) 

addRow ("Password", pPasswordLineEdit) 

addRow ("PasswordEchoOnEdit", pPasswordEchoOnEditLineEdit) 


pNormalLineEdit.setPlaceholderText ("Normal") 
pNoEchoLineEdit.setPlaceholderText ("NoEcho") 
pPasswordLineEdit.setPlaceholderText ("Password") 
pPasswordEchoOnEditLineEdit.setPlaceholderText 
("PasswordEchoOnEdit") 


# 设置 显示 效果 
pNormalLineEdit.setEchoMode (QLineEdit .Normal) 
pNoEchoLineEdit.setEchoMode (QLineEdit .NoEcho) 
pPasswordLineEdit.setEchoMode (QLineEdit. Password) 
pPasswordEchoOnEditLineEdit.setEchoMode 
(QLineEdit.PasswordEchoOnEdit) 


self.setLayout (flo) 


= perbu We 


= QApplication(sys.argv) 


win = lineEditDemo () 
win.show() 


sys.exit(app.exec_ ()) 


运行 脚本 ， 显 示 效 果 如 图 4-16 所 示 . 
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Password Password 
PasswordEchoOnEdit P asswordEchoOnEdit 
图 4-16 
案例 4-10 验证 器 


在 通常 情况 下 ， 我 们 会 对 用 户 的 输入 做 一 些 限制 ， 可 以 通过 验证 器 
来 进行 。 常 见 的 验证 器 有 : 整 型 验证 器 、 浮 点 型 验证 器 及 其 他 自 定义 验 
证 器 。 本 例文 件 名 为 PyQt5/Chapter04/qt04_lineEdit02.py， 其 完整 代码 如 


piIntLineEdit.setPlaceholderText (" 整 型 ") 
pDoubleLineEdit.setPlaceholderText (" 浮 点 型 ") 
pValidatorLineEdit.setPlaceholderText ("字母 和 数字 ") 


# 整 型 ， 范围 : ee 99] 
pintValidator = QIntValidator (self) 
pintValidator.setRange(1, 99) 


# FSA, WA: [-360, 360], HH: 小 数 点 后 两 位 
pDoubleValidator = QDoubleValidator (self) 
pDoubleValidator.setRange(-360, 360) 
pDoubleValidator.setNotation 


(QDoubleValidator.StandardNotation) 


pDoubleValidator.setDecimals (2) 


# 字母 和 数字 

reg = QRegExp("[a-zA-Z0-9]+$") 
pValidator = QRegExpValidator (self) 
pValidator.setRegExp (reg) 


# 设置 验证 器 

pintLineEdit.setValidator (pIntValidator) 
pDoubleLineEdit.setValidator (pDoubleValidator) 
pValidatorLineEdit.setValidator (pValidator) 


self.setLayout (flo) 


if Name == " main 3 
app = QApplication(sys.argv) 
win = lineEditDemo () 
win.show() 
SYS..Shit (app .exec ()) 


运行 脚本 ， 显 示 效 果 如 图 4-17 所 示 。 

















图 4-17 


案例 4-11 Fa A TRA 


要 限制 用 户 的 输入 ， 除 了 使 用 验证 器 ， 还 可 以 使 用 输入 掩 码 ， 常 见 
的 有 IP 地 址 、MAC 地 址 、 日 期 、 许 可 证 号 等 。 本 例文 件 名 为 
PyQt5/Chapter04/qt04_lineEdit03.py， 其 完整 代码 如 下 : 


from PyOt5.QtWidgets import QApplication, QLineEdit , QWidget , 
OFormLayout 
import sys 


class lineEditDemo (QWidget) : 
def anit (self, parent—None): 
Super (lineEditDemo, self). init (parent) 
self.setWindowTitle ("QLineEdit 的 输入 掩 码 例子 ") 


flo = QFormLayout () 
pIPLineEdit = QLineEdit () 
pMACLineEdit = QLineEdit () 
pDateLineEdit = QLineEdit () 
pLicenseLineEdit = QLineEdit () 


pIPLineEdit.setInputMask("000.000.000.000; ") 
pMACLineEdit.setInputMask ("HH:HH:HH:HH:HH:HH; ") 
pDateLineEdit.setInputMask ("0000-00-00") 
pLicenseLineEdit.setInputMask ( 
">AAAAA-AAAAA-AAAAA-AAAAA-AAAAA; #") 


flo.addRow ("3k F445", pIPLineEdit) 
flo.addRow ("Mac #44", pMACLineEdit) 
flo.addRow (" H #4445", pDateLineFdit) 
flo.addRow ("许可 证 掩 码 "， pLicenseLineEdit) 


self.setLayout (flo) 


if name == " main ™: 


app 
win = lineEditDemo () 


QApplication(sys.argv) 


win.show() 


SYS.exit (appsexec_()) 


运行 脚本 ， 显 示 效 果 如 图 4-18 所 示 。 
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图 4-18 


案例 4-12 综合 示例 
本 例文 件 名 为 ”PyQt5/Chapter04/qt04_lineEdit04.py， 演 示 在 窗口 中 
使 用 QLabel 标 签 控 件 的 综合 例子 。 其 完整 代码 如 下 : 





运行 脚本 ， 显 示 效 果 如 图 4-19 所 示 。 


Integer Validator 





Double validator 1234. 56 


Input Mask +91_ 2222 333333 
Text changed hello 
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Read Only Hello PyQt5 








图 4-19 


在 这 个 例子 中 ， 演 示 了 使 用 QLineEdit 对 象 的 一 些 方法 。 
第 1 个 文本 框 el， 显 示 文 本 使 用 自 定 义 字 体 、 右 对 齐 、 人 允许 输入 整 


第 2 个 文本 框 e2， 限 制 输入 小 数 点 后 两 位 。 

第 3 个 文本 框 e3， 需 要 一 个 输入 掩 码 应 用 于 电话 号 人 码 。 

第 4 个 文本 框 e:4， 需 要 发 射 信号 textChanged， 连 接 到 槽 疯 数 
textchanged(). 

第 5 个 文本 框 86， 设 置 显示 模式 EchoMode 为 Password， 需 要 发 射 
editingfinished 信 号 连接 到 覃 函数 enterPress0， 一 旦 用 户 按 下 了 回 车 键 ， 
该 函数 就 会 被 执行 。 

第 6 个 文本 框 86， 显 示 一 个 默认 的 文本 ， 不 能 编辑 ， 设 置 为 只 读 
的 。 


4.4.2 QTextEdit 





QTextEdit 类 是 一 个 多 行文 本 框 控件 ， 可 以 显示 多 行文 本 内 容 ， 当 
文本 内 容 超出 控件 显示 范围 时 ， 可 以 显示 水 平 个 垂直 滚动 条 。 
QTextEdit 不 仅 可 以 显示 文本 还 可 以 显示 HIML 文 档 。 

QTextEdit 类 中 的 第 用 方法 如 表 4-8 所 示 。 











表 4-8 


setPlainText() 设置 多 行文 本 框 的 文本 内 容 。 


toPlainText() 返回 多 行文 本 框 的 文本 内 容 。 


setHtml() 设置 多 行文 本 框 的 内 容 为 HTML CRY, HTML 文档 是 描述 网 页 的 。 
totHtml() 返回 多 行文 本 框 的 HTML 文档 内 容 。 


案例 4-13 QTextEdit 的 使 用 


本 例文 件 名 为 PyQt5/Chapter04/qt04_textEdit.py， 演 示 在 PyQt 5 的 
窗口 中 使 用 QTextEdit 控 件 。 其 完整 代码 如 下 : 





from PyQt5.QtWidgets import QApplication, QWidget , QTextEdit, 
QVBoxLayout , QPushButton 
import sys 


class TextEditDemo (QWidget) : 

def init (self, parent=None) : 
super (TextEditDemo, self). init (parent) 
self.setWindowTitle("OTextEdit 例子 ") 
self.resize(300, 270) 
self.textEdit = QTextEdit( ) 
self.btnPressl = OPushButton (" 显 示 文 本 ") 
self.btnPress2 = QPushButton (" 显 示 HTML") 
layout = QVBoxLayout () 
layout .addWidget (self.textEdit) 
layout.addWidget (self.btnPress1) 
layout.addWidget (self.btnPress2) 
self.setLayout (layout) 


self. btnPress1.clicked.connect (self.btnPress!l Clicked) 
Selle DEneress2.cluiicked | connece\(selt .btnPpress2 Clicked) 


def btnPressl Clicked(self): 
self.textEdit.setPlainText ("Hello PyQt5!\n 单 击 按钮 ") 


def btnPress2 Clicked(self); 
self.textEdit.setHtml ("<font color='red' size='6'><red>Hello 
PyQt51\n 单 击 按钮 。</font>") 


if name == " main _ 
app = QApplication(sys.argv) 
win = TextEditDemo () 
win.show() 


sys.exit (app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 4-20 所 示 。 

单 击 “ 显 示 文 本 ”按钮 ， 将 把 文本 内 容 显 示 到 textEdit 控件 中 ， 窗 口 
的 显示 效果 如 图 4-21 所 示 。 

单 击 “ 显 示 HTML” 按 钮 ， 将 把 HTML 文 档 内 容 显 示 到 textEdit 控 件 
中 ， 窗 口 的 显示 效果 如 图 4-22 所 示 。 可 以 看 到 ， 在 窗口 中 所 显示 的 
HTML 文 档 的 文本 字体 和 颜色 发 生 了 改变 ， 与 在 浏览 器 中 显示 的 网 页 效 
果 是 一 样 的 。 























图 4-20 





Hello PyQt5! 
单 击 按钮 














| 显示 文本 ] 


显示 HTILL 


图 4-21 
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图 4-22 


本 例 在 窗口 中 添加 了 一 个 ”QTextEdit ”控件 ”textEdit ”和 两 个 
QPushButton 控件 btnPress1、btnPress2。 以 下 代码 将 按钮 btnPressl 的 
clicked 信号 连接 到 覃 函数 btn_btnPress1_Clicked0)。 

self.btnPress1.clicked.connect(self.btnPress1_Clicked) 

当 按 钮 btnPressl ”被 按 下 时 会 触发 clicked ”信和 号， 然后 调用 
btnPress_ClickedO0， 最 后 把 文本 内 容 显示 到 textEdit 控件 中 。 同 理 ， 当 
单 击 ”btnPress2 ”按钮 后 ， 将 改变 QTextEdit 控 件 textEdit 的 显示 内 容 为 
HTML 文 档 。 


4.5 按钮 类 控 


L 


4.5.1 QAbstractButton 


在 任何 GUI 设计 中 ， 按 钮 都 是 最 重要 的 和 和 常用 的 触发 动作 请 求 的 方 
式 ， 用 来 与 用 户 进行 交互 操作 。 在 PyQt 中 根据 不 同 的 使 用 场景 将 按钮 划 
分 为 不 同 的 表现 形式 。 按 钮 的 基 类 是 QAbstractButton， 提 供 了 按钮 的 通 
用 性 功能 。QAbstractButton 类 为 抽象 类 ， 不 能 实例 化 ， 必 须 由 其 他 的 按 
钮 类 继承 QAbstractButton 类 ， 来 实现 不 同 的 功能 、 不 同 的 表现 形式 。 

常见 的 按钮 类 包括 : QPushButton、QToolButton、QRadioButton 和 
QCheckBox。 这 些 按钮 类 均 继 承 自 QAbstractButton 类 ， 根 据 各 自 的 使 用 
场景 通过 图 形 展现 出 来 。 

QAbstractButton 提 供 的 状态 如 表 4-9 所 示 。 














isDown() 提示 按钮 是 
isChecked() 提示 按钮 是 





否 被 按 下 
7 


i 已 经 标记 





isEnable() 提示 按钮 是 否 可 以 被 用 户 点 击 
设置 按钮 是 否 在 用 户 长 按时 可 以 自动 重复 执行 


QAbstractButton 提供 的 信号 如 表 4-10 所 示 。 





表 4-10 


AEE 


当 鼠 标 左 键 被 按 下 然后 释放 时 ， 或 者 快捷 键 被 释放 时 触发 该 信号 
当 按钮 的 标记 状态 发 生 改变 时 触发 该 信号 





4.5.2 QPushButton 


QPushButton 类 继承 自 QAbstractButton 类 ， 其 形状 是 长 方形 ， 文 本 
标题 或 图 标 可 以 显示 在 长 方形 上 。 它 也 是 一 种 命令 按钮 ， 可 以 单 击 该 按 
钮 执行 一 些 命令 ， 或 者 啊 应 一 些 事 件 。 常 见 的 有 “确认 “申请 “取消 ”“ 关 
闭 ”“ 是 ”“ 否 ”等 按钮 。 

命令 按钮 通常 通过 文本 来 描述 执行 的 动作 ， 有 时 候 也 会 通过 快捷 键 
来 执行 对 应 按钮 的 命令 。 

1.QPushButton 类 中 的 常用 方法 

QPushButton 类 中 的 常用 方法 如 表 4-11 所 示 。 











表 4-11 
setCheckable() 设置 按钮 是 否 已 经 被 选中 ， 如 果 设 置 为 True， 则 表示 按钮 将 保持 已 点 击 和 释放 状态 
toggle() 在 按钮 状态 之 间 进 行 切换 
设置 按钮 上 的 图 标 
设置 按钮 是 否 可 以 使 用 ， 当 设置 为 False 时 ， 按 钮 变 成 不 可 用 状态 ， 点 击 它 不 会 发 射 信号 
返回 按钮 的 状态 。 返 回 值 为 True 或 False 





) 

setDefault() 设置 按钮 的 默认 状态 
设置 按钮 的 显示 文本 
返回 按钮 的 显示 文本 


2. 为 QPushButton 设 置 快捷 键 
通过 按钮 名 字 能 大 QPushButton 设置 快捷 键 ， 比 如 名 字 
为 “<&Download” 的 按钮 ， 它 的 快捷 键 是 “Alt+D”。 其 规则 是 : 想 要 实现 








快捷 键 为 “Alt + D”， 那 么 按钮 的 名 字 里 就 要 有 这 个 字母 D， 并 且 在 字母 
D 前 面 加 上 “&”。 这 个 字母 D 一 般 是 按钮 名 称 的 首 字母 ， 而 且 在 按钮 显 
示 时 ,，“&”* 不 会 被 显示 出 来 ， 但 字母 D 会 显示 一 条 下 国 线 。 如 果 只 想 显 
示 “&”， 那 么 需要 像 转 义 一 样 使 用 “&&”。 更 多 的 关于 快捷 键 的 使 用 ， 请 
参考 QShortcut 类 。 其 核心 代码 如 下 : 
self.button=QPushButton("&Download") 




















self.button.setDefault(True) 
显示 效果 如 图 4-23 所 示 。 
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图 4-23 


案例 4-14 QPushButtoniğ 4H $ 


本 例文 件 名 为 PyQt5/Chapter04/qt0408_QButton.py， 演 示 在 PyQt 5 的 
窗口 中 使 用 QPushButton 按 钮 。 其 完整 代码 如 下 : 


import sys 
from PyOt5.QtCore import * 


from PyQt5.QtGui import * 
from PyOt5.QtWidgets import * 


class Form(QDialog) : 
def init (self, parent=None) : 
super(Form, self). init (parent) 


layout = QVBoxLayout () 


self.btnl = QPushButton("Buttonl") 
self.btnl.setCheckable (True) 

self.btnl.toggle() 

self.btnl.clicked.connect (lambda:self.whichbtn(self.btnl) ) 
self.btnl.clicked.connect (self.btnstate) 

layout.addWidget (self.btn1l) 


self.btn2 = QPushButton('image"') 

self. btn2.setIcon(QIcon(QPixmap("./images/python.png") ) ) 
self.btn2.clicked.connect (lambda:self.whichbtn(self.btn2) ) 
layout.addWidget (self.btn2) 

self.setLayout (layout) 


self.btn3 = QPushButton ("Disabled") 
self.btn3.setEnabled (False) 
layout.addWidget (self.btn3) 


self.btn4= QPushButton ("&Download") 
self.btn4.setDefault (True) 

self.btn4.clicked.connect (lambda:self.whichbtn(self.btn4) ) 
layout.addWidget (self.btn4) 

self.setWindowTitle ("Button demo") 


def btnstate (self): 
if self.btnl.isChecked(): 
print ("button pressed" ) 
else: 


print ("button released" ) 


def whichbtn(self,btn): 
print ("elicked button is " + bEnstext() ) 


TE name == ' main ': 





app = QApplication(sys.argv) 


btnDemo = Form() 
btnDemo. show () 


sys.exit(app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 4-24 所 示 。 
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代码 分 析 : 

在 这 个 例子 中 ， 创 建 了 btn1、btn2、btn3 和 btn4 ”四 个 按钮 ， 这 四 个 
QPushButton 对 象 被 定义 为 类 的 实例 变量 。 上 面 的 代码 符合 面向 对 象 的 
设计 思想 。 每 个 按钮 都 将 clicked 信 和 号 发 送 给 指定 的 模 函 数 ， 以 响应 按钮 
点 击 事件 。 

第 1 个 按钮 bmh1， 通 过 toggle() 函 数 来 切换 按钮 状态 。 其 核心 代码 





JE: 
self.btn1=QPushButton("Button1") 
self.btn1.setCheckable(True) 
self.btn1.toggle() 
HAAA, hf clicked(a y AIK 2774 R Abtnstate(), iw 
btn.isChecked 来 获得 按钮 是 个 和 被 点 击 或 释放 的 状态 。 其 核心 代码 是 : 





self.btn1.clicked.connect(self.btnstate) 
还 可 以 通过 lambda 的 方式 来 传递 额外 的 参数 btn1， 将 clicked 信 号 发 
送 给 槽 函数 whichbtn0。 其 核心 代码 是 : 
self.btn1.clicked.connect(lambda:self.whichbtn(self.btn1) ) 
第 2 个 按钮 bm2， 上 面 显示 一 个 图 标 。 使 用 setIcon0) 方 法 接收 一 个 
QPixmap 对 象 的 图 像 文件 作为 输入 参数 。 其 核心 代码 是 : 
self.btn2.setIcon(QIcon(QPixmap("./images/python.png"))) 
第 3 个 按钮 bm3， 使 用 setEnabled(0) 方 法 来 禁用 bnt3 按 钮 。 
self.btn3.setEnabled(False) 
第 4 个 按钮 btn4， 使 用 setDefaultO0 方 法 来 设置 按钮 的 默认 状态 。 人 快捷 
键 是 “& + 文本 ”(C&Download) ， 通 过 “Alt + D?” 快 捷 键 来 调用 覃 函数 。 
self.btn4=QPushButton("&Download") 
btn1、btn2 和 btn4 按 钮 都 通过 发 射 clicked 信 号 的 方式 连接 到 模 函 数 
whichbtn()， 这 里 使 用 lambda 的 方式 来 连接 权 函 数 ， 将 按钮 对 象 作为 参 
数 传递 ， 当 按钮 被 点 击 时 触发 信号 。 其 核心 代码 是 : 
self.btn4.clicked.connect(lambda:self.whichbtn(self.btn4)) 





4.5.3 QRadioButton 


QRadioButton 类 继承 自 QAbstractButton 类 ， 它 提供 了 一 组 可 供 选 择 
的 按钮 和 文本 标签 ， 用 户 可 以 选择 其 中 一 个 选项 ， 标 签 用 于 显示 对 应 的 
文本 信息 。 单 选 钮 是 一 种 开关 按钮 ， 可 以 切换 为 on 或 者 off， 即 checked 
或 者 unchecked， 主 要 是 为 用 户 提供 “多 选 一 ”的 选择 。 

QRadioButton 是 单 选 钮 控件 默认 是 独占 的 〈Exclusive) 。 对 于 继承 
自 同 一 个 父 类 Widget 的 多 个 单 选 钮 ， 它 们 属于 同一 个 按钮 组 合 ， 在 单 选 
钮 组 里 ， 一 次 只 能 选择 一 个 单 选 钮 。 如 果 需 要 多 个 独占 的 按钮 组 合 ， 则 
需要 将 它们 放 在 QGroupBox 或 QButtonGroup 中 。 





当 将 单 选 钮 切换 到 on 或 者 off IN, WERS toggled 信号 ， 绑 定 这 
个 信号 ， 在 按钮 状态 发 生 改 变 时 ， 触 发 相应 的 行为 。 
QRadioButton 类 中 的 常用 方法 如 表 4-12 所 示 。 





表 4-12 
setCheckable() 设置 按钮 是 否 已 经 被 选中 ， 可 以 改变 单 选 钮 的 选中 状态 ， 如 果 设 置 为 True， 则 表 


示 单 选 钮 将 保持 已 点 击 和 释放 状态 





isChecked() 返回 单 选 钮 的 状态 。 返 回 值 为 True 2% False 
setText() 设置 单 选 钮 的 显示 文本 
EEE 
在 QRadioButton 中 ，toggled 信 号 是 在 切换 单 选 钮 状态 CGF. K) 时 
发 射 的 ， 而 clicked 信 号 则 在 每 次 点 击 单 选 钮 时 都 会 发 射 。 在 实际 中 ， 一 
般 只 有 状态 改变 时 才 有 必要 去 响应 ， 因 此 toggled 信 号 更 适合 用 于 状态 监 


控 。 





案例 4-15 QRadioButtonjž £H H 


本 例文 件 名 为 PyQt5/Chapter04/qt0409_QRadio.py， 演 示 在 PyQt 5 的 
窗口 中 使 用 QRadioButton 按 钮 。 其 完整 代码 如 下 : 


import sys 

from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QtWidgets import * 


class Radiodemo (QWidget) : 
def amit (self; parent —None) 

super (Radiodemo, self). init (parent) 
layout = QHBoxLayout () 
self.btnl = QRadioButton ("Buttonl1") 
self.btnl.setChecked (True) 
self.btnl.toggled.connect (lambda:self.btnstate(self.btn1) ) 
layout.addWidget (self.btn1) 


self.btn2 = QRadioButton ("Button2") 
self.btn2.toggled.connect (lambda:self.btnstate(self.btn2) ) 
layout.addWidget (self.btn2) 

self.setLayout (layout) 

self.setWindowTitle ("RadioButton demo") 


def btnstate (self,btn) : 
if btn.text ()=="Buttonl": 
if btn.isChecked() == True: 
print( btn.text() + " is selected" ) 
else: 
print( btn.text() + " is deselected" ) 


if btn.text ()=="Button2": 
if btn.isChecked()== True 
print( btn.text() + " is selected" ) 
else: 
print( btn.text() + " is deselected" ) 
ai 
app = QApplication(sys.argv) 
radioDemo = Radiodemo () 
radioDemo. show () 


sys.exit(app.exec_ ()) 


运行 脚本 ， 显 示 效 果 如 图 4-25 所 示 。 


(@) Buttoni ( ) Button2 





图 4-25 


代码 分 析 : 
在 这 个 例子 中 ， 两 个 互 斥 的 单 选 钮 被 放置 在 窗口 中 。 
第 1 个 单 选 钮 btn1， 被 设置 成 默认 选中 状态 。 
self.btn1.setChecked(True) 
当选 择 两 个 按钮 相互 切换 时 ， 按 钮 的 状态 发 生 改 变 ， 将 触发 toggle 
信号 ， 并 与 模 函 数 binstate() 连 接 。 使 用 lambda 的 方式 允许 将 源 信号 传递 
给 槽 函数 ， 将 按钮 作为 参数 。 
self.btn1.toggled.connect(lambda:self.btnstate(self.btn1)) 
self.btn2.toggled.connect(lambda:self.btnstate(self.btn2)) 


当 发 射 toggled 信 号 后 ， 使 用 btnstate0 函 数 来 检查 按钮 的 状态 。 
4.5.4 QCheckBox 


QCheckBox 类 继承 自 QAbstractButton 类 ， 它 提供 了 一 组 带 文 本 标签 
的 复 选 框 ， 用 户 可 以 选择 多 个 选项 。 和 QPushButton 一 样 ， 复 选 框 可 以 
显示 文本 或 者 图 标 ， 其 中 文本 可 以 通过 构造 函数 或 者 setText() 来 设置 ; 
图 标 可 以 通过 setIcon(0) 来 设置 。 在 视觉 上 ，QBnuttonGroup 可 以 把 许多 复 
选 框 组 织 在 一 起 。 

QCheckBox (AHE) 和 QRadioButton 〈 单 选 钮 ) 都 是 选项 按钮 ， 
因为 它们 都 可 以 在 开 〈( 选 中 ) 或 者 关 〈 未 选中 ) 之 间 切 换 。 它 们 的 区 别 





是 对 用 户 选 择 的 限制 单 选 钮 提供 了 “多 选 一 ”的 选择 ;而 复 选 框 提供 的 
是 “多 选 多 ”的 选择 。 

QCheckBox 通 党 被 应 用 在 需要 用 户 选 择 一 个 或 多 个 可 用 的 选项 的 场 
景 中 。 

只 要 复 选 框 被 选中 或 者 取消 选中 ， 都 会 发 射 一 个 stateChanged 信 
与 。 如 果 想 在 复 选 框 状态 改变 时 触发 相应 的 行为 ， 请 连接 这 个 信号 ， 可 
以 使 用 isChecked0) 来 查询 复 选 框 是 否 被 选中 。 

除了 常用 的 选中 和 未 选中 两 种 状态 ，QCheckBox 还 提供 了 第 三 种 状 
态 〈 半 选中 ) 来 表明 “没有 变化 ”。 当 需要 为 用 户 提供 一 个 选中 或 者 未 选 
TE E: 这 种 状态 是 很 有 用 的 。 如 果 需 要 第 三 种 状态 ， 则 可 


以 通过 setTristate() 来 使 它 生 效 ， 并 使 用 checkState() 来 查询 当前 的 切换 状 
太 


7G oO 








QCheckBox 类 中 的 常用 方法 如 表 4-13 所 示 。 


表 4-13 


A UO Hi R 
setChecked() 设置 复 选 框 的 状态 ， 设 置 为 True 时 表示 选中 复 选 框 ， 设 置 为 False 时 表示 取消 选中 复 选 框 


SEH LCI 





isChecked() 检查 复 选 框 是 否 被 选中 
setTriState() 设置 复 选 框 为 一 个 三 态 复 选 杠 


三 态 复 选 框 有 三 种 状态 ， 如 表 4-14 所 示 。 








表 4-14 


Qt PartiallyChecked Pi] ite 


案例 4-16 QCheckBox 按 钮 的 使 用 
本 例文 件 名 为 PyQt5/Chapter04/qt0410_QCheckbox.py， 演 示 在 PyQt 





5 的 窗口 中 使 用 QCheckBox 按 钮 。 其 完整 代码 如 下 : 





layout.addWidget (self.checkBox1) 


self.checkBox2 = QCheckBox ("Checkbox2") 

self.checkBox2.toggled.connect( lambda:self.btnstate 
(self.checkBox2) ) 

layout.addWidget (self.checkBox2) 


self.checkBox3 = QCheckBox ("Checkbox3") 

self.checkBox3.setTristate (True) 

self.checkBox3.setCheckState (Qt.PartiallyChecked ) 

self.checkBox3.stateChanged.connect( lambda:self.btnstate 
(self.checkBox3) ) 

layout.addWidget (self.checkBox3) 


groupBox.setLayout (layout) 
mainLayout = QVBoxLayout () 
mainLayout.addWidget (groupBox) 


self.setLayout (mainLayout) 
self.setWindowTitle("CheckBox demo") 


def btnstate(self,btn ): 
chkiStatus = self.checkBoxl.text()+", isChecked="+ 


str( self.checkBoxl.isChecked() ) + ', checkState=' + 
str (self.checkBoxl.checkState() ) puypi 

chk2Status = self.checkBox2.text()+", isChecked="+ 
str( self.checkBox2.isChecked() ) + ', checkState=" + 
str(self.checkBox2.checkState() ) FENTO 

chk3Status = self.checkBox3.text()+", isChecked="+ 
str( self.checkBox3.isChecked() ) + ', checkState=' + 
str(self.checkBox3.checkState() ) +"\n" 


print (chklStatus + chk2Status + chk3Status ) 


if name == ' main ': 
app = QApplication(sys.argv) 
checkboxDemo = CheckBoxDemo () 
checkboxDemo. show () 
S¥S exit (app.exec ({)) 


运行 脚本 ， 显 示 效 果 如 图 4-26 所 示 。 


Checkboxes 


[V] Checkbox1 | | Checkbox2 [m] tristateBox 





图 4-26 


代码 分 析 : 
在 这 个 例子 中 ， 将 三 个 复 选 框 添加 到 一 个 水 平 布局 管理 器 中 ， 并 添 
加 到 一 个 QGroupBox 组 中 。 
groupBox=QGroupBox("Checkboxes") 





groupBox.setFlat( False ) 
=P tE HN stateChanged (i 5 Abe 2c 21] R BWstateChanged(). 
(EH lambda H 77 TARIE XT BR 25 FF EA Lo 
当 QCheckBox 状 态 改变 时 发 射 stateChanged 信 号 ， 当 信号 发 生 改 变 
时 触发 目 定 义 的 槽 函数 btnstate()。 
self.checkBox1.stateChanged.connect( 
lambda:self.btnstate(self.checkBox1) ) 
self.checkBox2.toggled.connect( 
lambda:self.btnstate(self.checkBox2) ) 
self.checkBox3.stateChanged.connect( 
lambda:self.btnstate(self.checkBox3) ) 
对 上 面 三 个 复 选 框 的 控件 说 明 ， 如 表 4-15 所 示 。 








表 4-15 


Er ena 


QCheckBox checkBox2 Checkbox2 两 种 状态 选择 
QCheckBox checkBox3 三 种 状态 选择 





实例 化 checkBox1 和 checkBox2 两 个 对 象 ， 并 将 checkBox1 的 状态 设 
置 为 选中 ， 为 checkBox1 设 置 快捷 键 ， 使 用 “&* 符 写 ， 如 “&Checkbox 
1”， 则 通过 “Alt+C” 快 捷 键 可 以 选中 checkBox1 复 选 框 。 
self.checkBox1=QCheckBox("&Checkbox1") 
self.checkBox1.setChecked(True) 
self.checkBox2=QCheckBox("Checkbox2") 
使 用 按钮 的 isChecked0 方 法 ， 判 断 复 选 框 是 个 被 选中 ， 其 核心 代码 
FE: 
chk1Status=self.checkBox1.text()+"",isChecked="+ 
str( self.checkBox1.isChecked() ) + ',;checkState=' + 
str(self.checkBox1.checkState()) +"\n" 
实例 化 一 个 QCheckBox 类 对 象 checkBox3， 然 后 使 用 setTristate(O) 开 
局 三 态 模 式 ， 其 核心 代码 是 : 
self.checkBox3=QCheckBox("Checkbox3") 
self.checkBox3.setTristate(True) 
self.checkBox3.setCheckState(Qt.PartiallyChecked ) 
self.checkBox3.stateChanged.connect( 
lambda:self.btnstate(self.checkB ox3) ) 


4.6 QComboBox ( FAYI T) 


QComboBox 是 一 个 集 按钮 和 下 拉 选 项 于 一 体 的 控件 ， 也 被 称 为 下 
拉 列 表 框 。QComboBox 类 中 的 常用 方法 如 表 4-16 所 示 。 





表 4-16 


addItem() 添加 一 个 下 拉 选 项 
addItems() 从 列表 中 添加 下 拉 选 项 
Clear() 删除 下 拉 选 项 集合 中 的 所 有 选项 








count() 返回 下 拉 选 项 集合 中 的 数目 
currentText() 返回 选中 选项 的 文本 

itemText( i ) 获取 索引 为 i 的 item 的 选项 文本 
currentIndex() 返回 选中 项 的 索引 


setltemText(int index,text) 改变 序号 为 index 项 的 文本 


QComboBox 类 中 的 常用 信号 如 表 4-17 所 示 。 








表 4-17 


o 


可 
Activated 当 用 户 选 中 一 个 下 拉 选 项 时 发 射 该 信号 
currentIndexChanged 当下 拉 选 项 的 索引 发 生 改 变 时 发 射 该 信号 
highlighted 当选 中 一 个 已 经 选中 的 下 拉 选 项 时 ， 发 射 该 信号 
案例 4-17 QComboBox 按 钮 的 使 用 


本 例文 件 名 为 ”PyQt5/Chapter04/qt0411_QComboBox.py， 演 示 在 
PyQt 5 的 窗口 中 使 用 QComboBox 按 钮 。 其 完整 代码 如 下 : 











运行 脚本 ， 显 示 效 果 如 图 4-27 所 示 。 


Python 


Python 





图 4-27 


代码 分 析 : 

在 这 个 例子 中 显示 了 一 个 下 拉 列 表 框 和 一 个 标签 ， 其 中 下 拉 列 表 框 
中 有 5 个 选项 ， 既 可 以 使 用 QComboBox 的 addItem0 方 法 添加 单个 选 
项 ， 也 可 以 使 用 addItems(0) 方 法 添加 多 个 选项 ;标签 显 示 的 是 从 下 拉 列 
表 框 中 选择 的 选项 ， 

self.ch=QComboBox() 
self.cb.addItem("C") 
self.cb.addItem("C++") 
self.cb.addItems(["Java","C#","Python"]) 

当下 拉 列 表 框 中 的 选项 发 生 改 变 时 将 发 射 currentIndexChanged 信 
号， 连接 到 目 定义 的 权 函 数 selectionchange()。 

self.cb.currentIndexChanged.connect(self.selectionchange) 

在 方法 中 ， 当 选中 下 拉 列 表 框 中 的 一 个 选项 时 ， 将 把 该 选项 的 文本 
设置 为 标签 的 文本 ， 并 调整 标签 的 大 小 。 


def selectionchange(self,i): 





self.lbl.setText( self.cb.currentText() ) 


4.7 QSpinBox (it 225 


QSpinBox 是 一 个 计数 器 控件 ， 人 允许 用 户 选 择 一 个 整数 值 ， 通 过 单 
击 向 上 /加 下 按钮 或 按键 盘 上 的 上 /下 和 葡 头 来 增加 /减少 当前 显示 的 值 ， 当 
然 用 户 也 可 以 输入 值 。 

在 默认 情况 下 ，QSpinBox 的 取 值 范围 是 0 一 99， 每 次 改变 的 步 长 值 
为 1。 

QSpinBox 类 和 QDoubleSpinBox 类 均 派 生 自 QAbstractSpinBox 
类 。QSpinBox 用 于 处 理 整 数值 ，QDoubleSpinBox 则 用 于 处 理 浮 点 值 ， 
它们 之 间 的 区 别 就 是 处 理 数 据 的 类 型 不 同 ， 其 他 功能 都 基本 相同 。 
QDoubleSpinBox 的 默认 精度 是 两 位 小 数 ， 但 可 以 通过 setDecimals() 来 改 
AP 

QSpinBox 类 中 的 利用 方法 如 表 4-18 所 示 。 








表 4-18 


设置 计数 器 的 最 大 值 、 最 小 值 和 步 长 值 
setValue() 设置 计数 器 的 当前 值 
Value() 返回 计数 器 的 当前 值 
设置 计数 器 的 步 长 值 
每 次 单 击 向 上 /向 下 按钮 时 ， ee oa 
valueChanged 信 号 ， 可 以 从 相应 的 槽 函数 中 通过 value() 函 数 获得 计数 器 
的 当前 值 。 











案例 4-18 QSpinBox 的 使 用 


本 例文 件 名 为 PyQt5/Chapter04/qt0412_QSpinBox.py， 演 示 在 PyQt 5 
的 窗口 中 使 用 QSpinBox。 其 完整 代码 如 下 : 





运行 脚本 ， 显 示 效 果 如 图 4-28 所 示 。 


current value:5 








图 4-28 


代码 分 析 : 
在 这 个 例子 中 ， 有 一 个 标签 和 计数 器 放置 在 一 个 垂直 布局 管理 器 
中 ， 并 把 这 个 垂直 布局 管理 器 放置 在 窗口 中 。 将 计数 器 的 valueChanged 
信号 连接 到 槽 函数 valuechange()。 其 核心 代码 是 : 
self.sp.valueChanged.connect(self.valuechange) 
valuechange() 函 数 把 计数 颖 的 当前 值 设 置 到 标签 文本 中 。 


self.11.setText("current value:" + str(self.sp.value()) ) 








4.8 QSlider (滑动 条 ) 


QSlider 控 件 提供 了 一 个 垂直 或 水 平 的 滑动 条 ， 清 动 条 是 一 个 用 于 控 
制 有 界 值 的 典型 控件 ， eae ala ica et 内 移动 
滑 块 ， 并 将 滑 块 所 在 的 位 置 转换 成 一 个 合法 范围 内 的 整数 值 。 有 时 候 这 
种 方式 比 输入 数字 或 者 使 用 SpinBox a 更 加 自然。 在 槽 函数 中 
对 滑 块 所 在 位 置 的 处 理 相 当 于 从 整数 之 间 的 最 小 值 和 最 高 值 进行 取 值 。 
一 个 滑 块 条 控件 可 以 以 水 平 或 垂直 的 方式 显示 ， 在 构造 函数 中 进行 
设置 。 
self.sp=QSlider(Qt.Horizontal) 
self.sp=QSlider(Qt. Vertical) 
QSlider 类 中 的 常用 方法 如 表 4-19 所 示 。 











表 4-19 


setMinimum() 
setMaximum() REES 
setSingleStep() 
setValue() 
value() 
setTickInterval() 设置 刻度 间隔 

setTickPosition() WE ， 可 以 输入 一 个 枚 举 值 ， 这 个 枚 举 值 指定 刻度 线 相对 于 
滑 块 和 用 户 操 作 的 位 置 。 以 下 是 可 以 输入 的 枚 举 值 : 

。 QSlider.NoTicks， 不 绘制 任何 刻度 线 

。QSlider.TicksBothSides， 在 滑 块 的 两 侧 绘制 刻度 线 

eè QSlider.TicksAbove, E (AE) 滑 块 上 方 绘制 刻度 线 

© QSlider.TicksBelow, 42 OKP) 滑 块 下 方 绘制 刻度 线 

。 QSlider.TicksLeft, Æ (HEFL) 滑 块 左 侧 绘制 刻度 线 

è QSlider.TicksRight， 在 (垂直 ) 滑 块 右 侧 绘制 刻度 线 








QSlider 类 中 的 常用 信号 如 表 4-20 所 示 。 


表 4-20 
当 滑 块 的 值 发 生 改 变 时 发 射 此 信号 。 此 信号 是 最 常用 的 





案例 4-19 QSlider 的 使 用 
本 例文 件 名 为 PyQt5/Chapter04/qt0413_QSlider.py， 演 示 在 PyQt 5 的 
窗口 中 使 用 QSlider 滑 动 条 控件 ， 随 着 滑动 条 的 移动 ， 标 签 的 字号 大 小 也 
随 着 发 生变 化 。 其 完整 代码 如 下 : 


# 连接 信号 楷 
self.sl.valueChanged.connect (self.valuechange) 


self.setLayout (layout) 


def valuechange (self): 
print ('current slider value=%s' % self.sl.value() ) 
size = self.sl.value() 


self.11.setFont (QFont ("Arial",size) ) 


if name == ' main _': 
app = QApplication(sys.argv) 
demo = SliderDemo () 
demo. show () 


SYS exit (app exec. ())) 


运行 脚本 ， 显 示 效 果 如 图 4-29 所 示 。 
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Hello PyQt5 











图 4-29 


代码 分 析 : 
在 这 个 例子 中 ， 将 一 个 标签 和 一 个 水 平滑 动 条 放置 在 一 个 垂直 布局 
管理 器 中 。 将 滑 块 的 valueChanged 信 号 连接 到 valuechange(O) 函 数 。 
self.sl.valueChanged.connect(self.valuechange) 
槽 函数 valuechangeO 读 取 清 块 的 当前 值 ， 并 将 其 作为 字号 的 大 小 。 
size=self.sl.value() 


self.11.setFont(QFont("Arial",size)) 


使 用 setTickInterval(5) 设 置 刻 度 间 隔 后 ， 在 绘制 刻度 时 惑 会 有 9 个 
刻度 点 〈 从 10 开 始 ， 每 隔 步 长 5 绘制 一 个 点 ， 到 50 处 结束 ) ， 也 就 是 
说 ， 刻 度 点 个 数 =( 最 大 值 -最 小 值 7 刻度 间隔 + 1， 本 例 中 的 刻度 点 个 数 
J: (50-10)/5 + 1=9。 

# 设置 最 小 值 
self.sl.setMinimum(10) 
# 设置 最 大 值 
self.sl.setMaximum(50) 
# 设置 刻度 间隔 
self.sl.setTickInterval(5) 





4.9 对 话 框 类 控 


4.9.1 QDialog 


为 了 更 好 地 实现 人 机 交互 ， 比 如 Windows 及 Linux 等 系统 均 会 提供 
一 系列 的 标准 对 话 框 来 完成 特定 场景 下 的 功能 ， 如 选择 字号 大 小 、 字 体 
颜色 等 。 在 PyQt 5 中 定义 了 一 系列 的 标准 对 话 框 类 ， 让 使 用 者 能 够 方便 
和 快捷 地 通过 各 个 类 完成 字号 大 小 、 字 体 颜色 以 及 文件 的 选择 等 。 

QDialog 类 的 子 类 主要 有 QMessageBox、QFileDialog、 
QFontDialog、QInputDialog 等 ， 这 些 内 容 在 本 节 都 会 介绍 到 。 

QDialog 类 的 继承 结构 如 图 4-30 所 示 。 
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图 4-30 





QDialog 类 中 的 常用 方法 如 表 4-21 所 示 。 


表 4-21 


H ak 


setWindowTitle() 设置 对 话 框 标题 


setWindowModality() 设置 窗口 模 态 。 取 值 如 下 : 


© Qt.NonModal， 非 模 态 ， 可 以 和 程序 的 其 他 窗口 交互 
© Qt.WindowModal， 窗 口 模 态 , 程序 在 未 处 理 完 当 前 对 话 框 时 ,将 阻止 和 对 话 框 


的 父 窗口 进行 交互 
© QtApplicationModal， 应 用 程序 模 态 ， 阻 止 和 任何 其 他 窗口 进行 交互 


案例 4-20 QDialog 的 使 用 
本 例文 件 名 为 PyQt5/Chapter04/qt0416_Dialog.py， 演 示 在 PyQt 5 的 
窗口 中 使 用 QDialog。 其 完整 代码 如 下 : 





import sys 
from PyQt5.QtCore import * 





运行 脚本 ， 显 示 效 果 如 图 4-31 所 示 。 


E Dialog 例子 - 0 


弹出 对 话 框 


ok 


图 4-31 


代码 分 析 : 

在 这 个 例子 中 ，Dialog 窗 口 的 WindowModality 属 性 决定 是 否 为 模 态 
或 非 模 态 。 当 用 户 按 下 Esc 键 时 ， 对 话 框 窗口 将 会 默认 调用 
QDialog.reject() 方 法 ， 然 后 关闭 对 话 框 窗口 。 

单 击 QWidget 窗 口中 的 PushButton 按 钮 时 ， 将 生成 一 个 对 话 框 窗 
口 。 在 对 话 框 窗口 的 标题 栏 上 没有 最 小 化 和 最 大 化 控件 。 以 下 代码 将 给 
24H WH clicked{a “5 Ys JINN ek Blshowdialog(). 

self.btn.clicked.connect(self.showdialog) 

由 于 Dialog 窗 口 的 WindowModality 属 性 设置 为 Qt.ApplicationModal 
模 态 ， 用 户 只 有 关闭 所 弹出 的 对 话 框 窗口 后 ， 才 能 关闭 主 窗口 。 以 下 代 
码 用 于 设置 对 话 框 模 态 : 

dialog.setWindowModality(Qt.ApplicationModal) 





4.9.2 QMessageBox 


QIMessageBox 是 一 种 通用 的 弹出 式 对 话 框 ， 用 于 显示 消息 ， 人 允许 用 
户 通 过 单 击 不 同 的 标准 按钮 对 消息 进行 反 饿 。 每 个 标准 按钮 都 有 一 个 预 
定义 的 文本 、 角 色 和 十 六 进 制 数 。 

QMessageBox 类 提供 了 许多 党 用 的 弹出 式 对 话 框 ， 如 提示 、 警 告 
音 误 、 询 问 、 关 于 等 对 话 框 。 这 些 不 同类 型 的 QMessageBox 对 话 框 只 
显示 时 的 图 标 不 同 ， 其 他 功能 是 一 样 的 。 

QMessageBox 类 中 的 常用 方法 如 表 4-22 所 示 。 





日 
征 





表 4-22 


information(QWidget parent,title, text, buttons, | 弹出 消息 对 话 框 ， 各 参数 解释 如 下 : 
defaultButton) eparent， 指 定 的 父 窗 口 控件 

etitle， 对 话 框 标题 

etext， 对 话 框 文本 

e buttons: 多 个 标准 按钮 ， 默 认为 OK 按钮 

e defaultButton: 默认 选中 的 标准 按钮 ， 默 认 是 第 一 个 标准 按钮 
question(QWidget parent,title, text, buttons, defaultButton) | 弹出 问答 对 话 框 (各 参数 解释 同上 ) 


warning(QWidget parent,title, text, buttons, defaultButton) | 弹出 警告 对 话 框 (各 参数 解释 同上 ) 





ctitical(QWidget parent,title, text, buttons, defaultButton) 弹出 严重 错误 对 话 框 (各 参数 解释 同上 ) 
about(QWidget parent,title, text) 弹出 关于 对 话 框 (各 参数 解释 同上 ) 


setTitle() 设置 标题 
setText() 设置 消息 正文 
setIcon() 设置 弹出 对 话 框 的 图 片 


QMessageBox 的 标准 按钮 类 型 如 表 4-23 所 示 。 











表 4-23 


QMessage.Yes 





5 种 常用 的 消 轧 对 话 框 及 其 显示 效果 如 表 4-24 所 示 。 


表 4-24 


消息 对 话 框 ， 用 来 告诉 用 户 关 于 提示 消息 = 
QMessageBox.information(self, "$x i", "W SOM ii HE IE 3c", 
QMessageBox. Yes | QMessageBox.No, QMessageBox. Yes ) 





提问 对 话 框 ， 用 来 告诉 用 户 关于 提问 消息 = a x | 
QMessageBox.question(self, "标题 " " $e A) HE GH MIE X", 
QMessageBox. Yes | QMessageBox.No, QMessageBox. Yes ) 


sh | 提问 框 消息 正文 








警告 对 话 框 ， 用 来 告诉 用 户 关于 不 寻常 的 错误 消息 
QMessageBox.warning(self, "标题 "， "警告 框 消 息 正 文 "， 
QMessageBox.Yes | QMessageBox.No, QMessageBox. Yes ) 











严重 错误 对 话 框 ， 用 来 告诉 用 户 关 于 严重 的 错误 消息 = Ej 


QMessageBox.critical(self, "标题 "，" 严 重 错误 对 话 框 消息 正文 "， rx) 严重 错误 对 话 框 消息 正文 
QMessageBox.Yes | QMessageBox.No, QMessageBox. Yes ) 








关于 对 话 框 
QMessageBox.about(self, "标题 ", "关于 对 话 框 " ) 








案例 4-21 QMessageBox 的 使 用 


本 例文 件 名 为 PyQt5/Chapter04/qt04_.QMessageBox.py， 演 示 在 PyQt 
5 的 窗口 中 使 用 QMessageBox 控 件 。 其 完整 代码 如 下 : 





运行 脚本 ， 显 示 效 果 如 图 4-32 所 示 。 
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图 4-32 
4.9.3 QInputDialo 


QInputDialog ”控件 是 一 个 标准 对 话 框 ， 由 一 个 文本 框 和 两 个 按钮 
(OK 按钮 和 Cancel 按钮 ) 组 成 。 当 用 户 单 击 OK 按钮 或 按 Enter 键 
后 ， 在 父 窗口 可 以 收集 通过 QInputDialog 控 件 输入 的 信息 。QInputDialog 
控件 是 QDialog 标 准 对 话 框 的 一 部 分 。 

在 QInputDialog 控 件 中 可 以 输入 数字 、 字 符 串 或 列表 中 的 选项 。 标 
签 用 于 提示 必要 的 信息 。 

QInputDialog 类 中 的 常用 方法 如 表 4-25 所 示 。 





表 4-25 


案例 4-22 QInputDialog 的 使 用 
本 例文 件 名 为 PyQt5/Chapter04/qt04_QInputDialog.py， 演 示 在 PyQt 5 





的 窗口 中 使 用 QInputDialog 控 件 。 其 完整 代码 如 下 : 





layout .addRow (self.btn2,self.le2) 


self.btn3 = QPushButton (" 获 得 整数 ") 
self.btn3.clicked.connect (self.getInt) 
self.le3 = QLineEdit () 
layout.addRow(self.btn3,self.le3) 


self.setLayout (layout) 
self.setWindowTitle("Input Dialog 例子 ") 





def getItem(self): 
items = (TOM; “GLEN, “dava", "Python”) 
item, ok = QInputDialog.getItem(self, "select input dialog", 
"AEN", items, 0, False) 
if ok and item: 
self.lel.setText (item) 


def getIext (self): 
text, ok = QInputDialog.getText (self, 'Text Input Dialog', ' 输 


入 姓名 :') 
Lf Oke 
self.le2.setText (str (text) ) 
def getInt (self): 
num, ok=QInputDialog.getInt(self,"integer input dualog", "输入 数 
=") 
it ok; 
self.le3.setText (str (num) ) 
if name == ' main_': 


app = QApplication(sys.argv) 
demo = InputdialogDemo () 
demo. show () 


sys.exit(app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 4-33 至 图 4-36 所 示 。 
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图 4-33 
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图 4-36 


代码 分 析 : 

在 这 个 例子 中 ， 在 QFormLayout 布 局 管理 器 中 放置 了 三 个 按钮 和 三 
个 文本 框 。 当 单 击 按钮 时 ， 将 弹出 标准 对 话 框 ， 把 按钮 的 单 击 信号 与 自 
定义 的 槽 函数 连接 起 来 。 

self.btn1.clicked.connect(self.getItem) 
self.btn2.clicked.connect(self.gettext) 
self.btn3.clicked.connect(self.getint) 

当 调 用 QImputDialog.getItem0O 函 数 时 ，QInputDialog 控 件 包 含 一 个 
QCombox 控 件 和 两 个 按钮 ， 用 户 从 QCombox 中 选择 一 个 选项 后 ， 人 允许 
用 户 确 认 或 取消 操作 。 

def getItem(self): 
items=("C"","C++","Java","Python") 
item,ok=QInputDialog.getItem(self,"select input dialog", 
"语言 列表 ",items,0,False) 
if ok and item: 
self.le1.setText(item) 

同 理 ， 当 调用 QInputDialog.getText() 函 数 时 ，QInputDialog 控 件 包含 

一 个 文本 框 和 两 个 按钮 ， 人 允许 用 户 输 入 字符 串 ， 当 调用 


QInputDialog.getInt() 函 数 时 ，QInputDialog 包 含 一 个 QSpinBox 控 件 和 两 
个 按钮 ， 人 允许 用 户 输入 整数 。 


4.9.4 QFontDialog 


QFontDialog 控 件 是 一 个 常用 的 字体 选择 对 话 框 ， 可 以 让 用 户 选 择 
所 显示 文本 的 字号 大 小 、 样 式 和 格式 。QFontDialog 是 QDialog 标准 对 
话 框 的 一 部 分 。 使 用 QFontDialog 类 的 静态 方法 getFont()， 可 以 从 字体 选 
择 对 话 框 中 选择 文本 的 显示 字号 大 小 、 样 式 和 格式 。 
案例 4-23 QFontDialog 的 使 用 
本 例文 件 名 为 PyQt5/Chapter04/qt04_QFontDialog.py， 演 示 在 PyQt 
5 的 窗口 中 使 用 QFontDialog 控 件 。 其 完整 代码 如 下 : 











运行 脚本 ， 显 示 效 果 如 图 4-37 所 示 。 


a Font Dialog 例子 - A 
choose font 
Hello, 测 试 字体 例子 T Select Font 
Font Font style Size 
Agency FB Normal 9 
Agency FB “ Normal 6 A 
Aharoni Bold 7 
Aldhabi Italic 8 
Algerian Bold Italic 9 
v 
: ， O y 
Effects Sanple 
|_| Strikeout 
|_| Underline AaflbY yZ2 
Writing Systen 
Any > 
OK Cancel 








图 4-37 
代码 分 析 : 
在 这 个 例子 中 ， 通 过 字体 选择 对 话 框 选择 相应 的 字体 ， 并 且 所 选择 
字体 的 效果 显示 在 QLineEdit 的 文本 上 。 
实例 化 fontButton 和 fontLineEdit 对 象 ， 并 将 fontButton 的 clicked 信 号 
和 槽 函数 getFontO 绑 定 在 一 起 。 
self.btn=QPushButton("choose font") 
self.btn.clicked.connect(self.getFont) 
self.le=QLabel("Hello, 测 试 字体 例子 ") 
创建 QVBoxLayout 布局 ， 在 垂直 布局 管理 器 中 添加 fontButton 和 
fontLineEdit 组 件 ， 并 按照 相应 的 位 置 深 加 到 栅 格 布局 中 。 
layout=QV BoxLayout() 
layout.addWidget(self.btn) 





layout.addWidget(self.le) 
当 单 击 fontButton 按 钮 时 ， 将 clicked 信 号 发 送 到 覃 函数 getFontO 中 。 
self.fontButton.clicked.connect(self.getFont) 
自 定 义 槽 函数 ， 选 择 字 体 ， 并 将 字体 效果 设置 到 fontLineEdit 中 。 
getFont() 方 法 返回 的 为 元 组 类 型 ， 同 时 返回 所 选择 的 字体 和 函数 执行 的 








def getFont(self): 
font,ok=QFontDialog.getFont() 
if ok: 
self.fontLineEdit .setFont(font) 


4.9.5 QFileDialo 


QFileDialog 是 用 于 打开 和 保存 文件 的 标准 对 话 框 。QFileDialog 类 
继承 自 QDialog 类 。 

QFileDialog 在 打开 文件 时 使 用 了 文件 过 滤器 ， 用 于 显示 指定 扩展 名 
的 文件 。 也 可 以 设置 使 用 QFileDialog 打 开 文 件 时 的 起 始 目 录 和 指定 扩展 
名 的 文件 。 

QFileDialog 类 中 的 常用 方法 如 表 4-26 所 示 。 





表 4-26 


返回 用 户 所 选择 文件 的 名 称 ， 并 打开 该 文件 





使 用 用 户 选择 的 文件 名 并 保存 文件 


续 表 


描 述 
setFileMode() 可 以 选择 的 文件 类 型 ， 枚 举 常量 是 : 
。 QFileDialog.AnyFile， 任 何 文 件 





e QFileDialog.ExistingFile， 己 存在 的 文件 
。 QFileDialog.Directory， 文 件 目录 


è QFileDialog.ExistingFiles， 已 经 存在 的 多 个 文件 
setFilter() 设置 过 滤器 ， 只 显示 过 滤器 允许 的 文件 类 型 








案例 4-24 QFileDialog 的 使 用 


本 例文 件 名 为 PyQt5/Chapter04/qt04_QFileDialog.py， 演 示 在 PyQt 5 
的 窗口 中 使 用 QFileDialog 控 件 。 其 完整 代码 如 下 : 





运行 脚本 ， 显 示 效 果 如 图 4-38、 图 4-39 和 图 4-40 所 示 。 
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T File Dialog 例子 一 


加 载 图 片 





加 载 文 本 文件 


Methods defined here: 


convertFromPlainText(...) 
convertFromPlainText(str, node: 
VhiteSpaceMode = Qt. WhiteSpacePre) -> str 


| 
| 
| 
| 
| 
Q 


Ge 

| 

| mightBeRichText(...) 

| mightBeRichText(str) -> bool 
| 
| 


| veakref 





图 4-40 





代码 分 析 : 

在 这 个 例子 中 ， 通 过 文件 对 话 框 来 选择 文件 ， 其 中 第 一 个 文件 对 话 
框 只 允许 打开 图 片 文件 ， 并 把 所 加 载 的 图 片 显示 在 标签 “QLabel) 中 ; 
第 二 个 文件 对 话 框 只 允许 打开 文本 文件 ， 并 把 文本 内 容 显 示 在 文本 框 

(QTextEdit) A. 

第 一 个 按钮 使 用 QFileDialog.getOpenFileNam()， 调 用 文件 对 话 框 来 
显示 图 像 ， 并 显示 在 一 个 标签 控件 中 。 它 负责 打开 C 盘 目录 下 的 文件 。 
其 核心 代码 如 下 : 

fname，=QFileDialog.getOpenFileName(self,Open file','c:\\', "Image 
files (*.jpg *.gif)") 
self.le.setPixmap(QPixmap(fname)) 
fEQFileDialog.getOpenFileNam() csi 2 #: 

e 第 一 个 参数 用 于 指定 父 组 件 ; 

o 第 二 个 参数 是 QFileDialog 对 话 框 的 标题 ; 

© 第 三 个 参数 是 对 话 框 显 示 时 默认 打开 的 目录 ,“.” 代 表 程 序 运行 目 
录 ，“/ 代 表 当 前 盘 下 的 根 目 录 《〈 在 Windows、Linux BF“ WRI A 
K) 。 需 要 注意 不 同 平台 下 路 径 的 显示 方式 ， 比 如 Windows 平 台 下 的 C 
Bree 

e 第 四 个 参数 是 对 话 框 中 文件 扩展 名 过 滤 右 〈Filter) 。 比 如 使 
用 “Tmage files (*.jpg *.gif)” 表 示 只 能 显示 扩展 名 为 .jpg 或 .gif 的 文件 。 

第 二 个 按钮 使 用 文件 对 话 框 (QFileDialog〉 对 象 的 exec_0 〇 方法 来 选 
择 文件 ， 并 把 所 选 文件 的 内 容 显 示 在 文本 编辑 控件 中 。 其 核心 代码 如 
下 : 
































def getfiles(self): 
dig=QFileDialog() 
dig.setFileMode(QFileDialog.AnyFile) 
dig.setFilter( QDir.Files ) 


if dlg.exec_(): 
filenames=dlg.selectedFiles() 
f=open(filenames[0],'r') 
with f: 
data=f.read() 


self.contents.setText(data) 


4.10 窗口 绘图 类 控件 





本 节 主 要 介绍 如 何 实现 在 窗口 中 绘图 。 在 PyQt5 中 ， 一 般 可 以 通过 
QPainter、QPen 和 QBrush 这 三 个 类 来 实现 绘图 功能 。 此 外 ，QPixmap 的 
作用 是 加 载 并 呈现 本 地 图 像 ， 而 图 像 的 呈现 本 质 上 也 是 通过 绘图 方式 实 
现 的 ， 所 以 QPixmap 也 可 以 被 视 为 绘图 的 一 个 类 。 


4.10.1 QPainter 


QPainter 类 在 QWidget GZ) 上 执行 绘图 操作 ， 它 是 一 个 绘制 工 
有 具 ， 为 大 部 分 图 形 界面 提供 了 高 度 优化 的 函数 ， 使 QPainter 类 可 以 绘制 
从 简单 的 直线 到 复杂 的 饼 图 等 。 

绘制 操作 在 QWidget.paintEvent() 中 完成 。 绘 制 方法 必须 放 在 
QtGui.QPainter 对 象 的 begin0 和 end0 之 间 。QPainter 类 在 控件 或 其 他 绘图 
设备 上 执行 较 低级 别 的 图 形 绘制 功能 ， 并 通过 如 表 4-27 所 示 的 方法 进行 
绘制 。 

表 4-27 


方 法 
begin() 开始 在 目标 设备 上 绘制 











drawArc() 在 起 始 角 度 和 最 终 角度 之 间 男 弧 
drawEllipse() 在 一 个 矩形 内 画 一 个 椭圆 


续 表 


A 5 
drawLine(int x1, int yl, int x2, int y2) 绘制 一 条 指定 了 端点 坐标 的 线 。 绘 制 从 (xl, y1) 到 (x2, y2) 的 直线 并 且 
设置 当前 画笔 位 置 为 (x2, y2) 


以 给 定 的 宽度 w 和 高 度 h 从 左上 角 坐 标 (x, y) 绘 制 一 个 矩形 
显示 给 定 坐标 处 的 文字 


setPen() 设置 用 于 绘制 的 笔 的 颜色 、 大 小 和 样式 
还 可 以 设置 画笔 风格 (PenStyle) ， 这 是 一 个 枚 举 类 ， 可 以 由 
QPainter 类 绘制 。 画 笔 风 格 如 表 4-28 所 示 。 效 果 如 图 4-41 所 示 。 








表 4-28 


没有 线 。 比 如 QPainter drawRect0) 填 充 ， 但 没有 绘制 任何 边界 线 
由 一 些 像素 分 隔 的 短线 
轮流 交替 的 点 和 短线 


as] Pen Styles .ox 


setWidth(0) setWidth(2) setWidth(3) setWidth(4) 








NoPen 

SolidLine 一 -一 下 $ 和 一 

DashLine 一 一 一 一 -----------: ee eee ees See eee 
DotLine --------------- ooooooooooooooooooooe seeeeeeeseseeeee SSSESSESSEES 
DashDotLine 一 -一 -一 -一 - re eee om N a a a a a a 1 


DashDotDotLine rer ee a 





本 例文 件 名 为 PyQt5/Chapter04/qt04_drawText.py， 演 示 在 一 个 窗口 
中 绘制 文字 。 其 完整 代码 如 下 : 


import sys 
from PyQt5.QtWidgets import QApplication ,QWidget 





运行 脚本 ， 显 示 效 果 如 图 4-42 所 示 。 





c 在 窗口 中 绘制 一 oR 


欢迎 学 习 PyQt5 








图 4-42 


代码 分 析 ; 
在 这 个 例子 中 ， 首 先 定义 了 等 绘制 的 文字 。 


class Winform(QWidget) : 
def init (self£,parent=None) : 


self.text = 'kig# pyots' 


然后 ， 定 义 了 一 个 绘制 事件 ， 所 有 的 绘制 操作 都 发 生 在 此 事件 内 。 
绘制 事件 的 核心 代码 如 下 : 


def paintEvent (self,event): 
painter = QPainter(self) 
painter.begin (self) 
# 自 定 义 绘 制 方法 
self.drawText (event, painter) 


painter.end() 


QtGui.QPainter 类 负责 所 有 低级 别 的 绘制 ， 所 有 的 绘制 方法 都 要 放 
在 begin() Mend) 之 间 。 这 个 例子 放置 的 是 自 定 义 的 drawText() 方 法 。 
自 定义 的 绘制 方法 的 核心 代码 如 下 : 


def drawText (self, event, qp): 
# 设置 笔 的 颜色 
qp.setPen( QColor(168, 34, 3) ) 
# 设置 字体 
qp.setFont( QFont('SimSun', 20) ) 
绘制 文字 


qp.drawText (event.rect(), Qt.AlignCenter, self.text) 


案例 4-26 绘制 点 





在 上 一 节 中 使 用 QPainter 绘 制 了 一 段 文 字 ， 文 字 在 屏幕 上 的 显示 是 


由 一 个 个 点 (point) 组 成 的 ， 本 节 主 要 讲解 使 用 QPainter 绘 


| 点 


INO 


本 例文 件 名 为 PyQt5/Chapter04/qt04_drawPoint.py， 演 示 使 用 


QPainter 在 窗口 中 绘制 一 个 个 点 。 其 完整 代码 如 下 : 


import sys, math 

from PyQt5.QtWidgets import * 
from PyQt5.QtGui import * 
from PyQt5.QtCore import Qt 


class Drawing (QWidget) : 
def init (self, parent=None): 


super (Drawing, self). init (parent) 





运行 脚本 ， 显 示 效 果 如 图 4-43 所 示 。 





图 4-43 


代码 分 析 : 
在 这 个 例子 中 ， 在 窗口 的 工作 区 绘制 正弦 函数 图 形 ， 周 期 是 
[-100,100]。 
for i in range(1000): 
x=100 *(-1+2.0*i/1000)+ size.width()/2.0 
=-50 * math.sin((x- size.width()/2.0)*math.pi/50) + 
size. height()/2.0 
qp.drawPoint(x,y) 
画笔 设置 为 红色 ， 使 用 预定 义 的 Qtred 颜 色 。 
qp.setPen( Qt.red ) 
每 次 调整 窗口 大 小 时 ， 都 会 生成 一 个 绘图 事件 。 使 用 size() 方 法 得 
到 窗口 的 当前 大 小 ， 在 新 的 窗口 中 随机 分 布 工作 区 中 的 点 。 
size=self.size() 
使 用 drawPointO 方 法 绘制 一 个 个 点 。 


qp.drawPoint(x,y) 


4.10.2 QPen 


QPen (WE) 是 一 个 基本 的 图 形 对 象 ， 用 于 绘制 直线 、 曲 线 或 者 
给 轮廓 画 出 矩形 、 椭 圆 形 、 多 边 形 及 其 他 形状 等 。 


案例 4-27 QPen 的 使 用 


本 例文 件 名 为 PyQt5/Chapter04/qt04_drawPen.py， 演 示 使 用 QPen 在 
窗口 中 绘制 和 目 定义 的 形状 。 其 完整 代码 如 下 : 


import sys 

from PyQt5.QtWidgets import * 
from PyOt5.QtGui import * 
from PyQt5.QtCore import Qt 


class Drawing (QWidget) : 
def init (self): 
super () Init () 
self.initUI () 


demo .Show () 


SYySwexit(app exec ()) 


运行 脚本 ， 显 示 效 果 如 图 4-44 所 示 。 


© 钢笔 样式 例子 一 OE 








代码 分 析 : 

在 这 个 例子 中 ， 使 用 6 种 不 同 的 线条 样式 绘制 了 6 条 线 ， 其 中 前 5 条 
线 使 用 的 是 预定 义 的 线条 样式 。 也 可 以 自 定 义 线条 样式 ， 最 后 一 条 线 就 
是 使 用 自 定义 的 线条 样式 绘制 的 。 

以 下 代码 创建 了 一 个 QPen 对 象 。 为 了 能 更 清晰 地 看 清 各 线 之 间 的 
差异 ， 将 颜色 设置 成 黑色 ， 宽 度 设置 为 2 像素 (px) 。Qt.SolidLine 是 预 
定义 的 线条 样式 之 一 。 

pen=QPen(Qt.black,2,Qt.SolidLine) 

以 下 代码 自 定 义 了 一 种 线条 样式 。 使 用 Qt.CustomDashLine 创建 线 
条 样式 ， 然 后 调用 setDashPattern() 方 法 使 用 数字 列表 定义 样式 。 数 字 列 
表 的 个 数 必 须 是 偶数 ， 在 本 例 中 数字 列表 是 [14,5,4]， 它 的 个 数 是 4。 在 
数字 列表 中 ， 奇 数位 〈 数 字 列 表 中 的 第 1,3,5 等 位 置 ) 代表 一 段 横 线 ， 偶 





数位 〈 数 字 列 表 中 的 第 2,4,6 等 位 置 ) 代表 两 段 横 线 之 间 的 空余 距离 。 在 
数字 列表 中 数字 越 大 ， 横 线 和 空余 距离 就 越 大 。 本 例 中 数字 列表 
[1,4,5,4] 代 表 的 意义 是 : 1 像素 宽度 的 横 线 ，4 像 素 宽 度 的 空余 距离 ，5 像 
素 宽 度 的 横 线 ，4 像 素 宽度 的 空余 距离 。 

pen.setStyle(Qt.CustomDashLine) 

pen.setDashPattern([1,4,5,4]) 

qp.setPen(pen) 

qp.drawLine(20,240,250,240) 


4.10.3 QBrush 


QBrush (MH 是 一 个 基本 的 图 形 对 象 ， 用 于 填充 如 矩形 、 椭 圆 形 
或 多 边 形 等 形状 。QBrush 有 三 种 类 型 : 预定 义 、 过 渡 和 纹理 图 案 。 
案例 4-28 QBrush 的 使 用 
本 例文 件 名 为 PyQt5/Chapter04/qt04_drawBrush.py， 演 示 使 用 
QBrush 在 窗口 中 填充 不 同 背景 的 定形 。 其 完整 代码 如 下 : 








运行 脚本 ， 显 示 效 果 如 图 4-45 所 示 。 





画 刷 例子 - O ES 
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图 4-45 








代码 分 析 : 
在 这 个 例子 中 ， 在 窗口 中 绘制 出 9 种 不 同 背 景 填充 的 矩形 。 
以 下 代码 定义 了 QBrush 对 象 ， 然 后 将 QPainter 对 象 的 画 刷 设置 成 
QBrush 对 象 ， 并 通过 调用 drawRect() 方 法 绘制 矩形 。 
brush=QBrush(Qt.SolidPattern) 
qp.setBrush(brush) 
qp.drawRect(10,15,90,60) 


4.10.4 QPixmap 


QPixmap 类 用 于 绘图 设备 的 图 像 显示 ， 它 可 以 作为 一 个 
QPaintDevice 对 象 ， 也 可 以 加 载 到 一 个 控件 中 ， 通 常 是 标签 或 按钮 ， 用 
于 在 标签 或 按钮 上 显示 图 像 。 

QPixmap ”可 以 读 取 的 图 像 文 件 类 型 有 BMP, GIF, JPG, JPEG, 
PNG、PBM、PGM、PPM、XBM、XPM 等 。 





QPixmap 类 中 的 常用 方法 如 表 4-29 所 示 。 


表 4-29 
copy() 从 QRect 对 象 复制 到 QPixmap 对 象 
fromImage() 将 QImage 对 象 转换 为 QPixmap WR 


grabWidget() 从 给 定 的 窗口 小 控件 创建 一 个 像素 图 





在 窗口 中 创建 数据 的 像素 图 
load() 加 载 图 像 文件 作为 QPixmap 对 象 
save() 将 QPixmap 对 象 保存 为 文件 


案例 4-29 QPixmap 的 使 用 








本 例文 件 名 为 PyQt5/Chapter04/qt04_QPixmap.py， 演 示 在 PyQt 5 的 
窗口 中 使 用 QPixmap 控 件 。 其 完整 代码 如 下 : 
import sys 
from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QtWidgets import * 


if__name_=='_main_': 
app=QApplication(sys.argv) 

win=QWidget() 

lab1=QLabel() 
lab1.setPixmap(QPixmap("./images/python.jpg")) 
vbox=QVBoxLayout() 

vbox.addWidget(lab1) 

win.setLayout(vbox) 
win.setWindowTitle("QPixmap 例子 ") 
win.show() 


sys.exit(app.exec_()) 


运行 脚本 ， 显 示 效 果 如 图 4-46 所 示 。 





| az QPixmap 例子 - O ES 








图 4-46 


代码 分 析 : 

在 这 个 例子 中 ， 使 用 setPixmapO 将 图 像 显示 在 QLabel 上 。 
lab1=QLabel() 
lab1.setPixmap(QPixmap("./images/python.jpg")) 


4.11 与 前 中 


4.11.1 Drag 与 Drop 


为 用 户 提供 的 拖 忠 功能 很 直观 ， 在 很 多 加 面 应 用 程序 中 ， 复 制 或 移 
动 对 象 都 可 以 通过 拖 电 来 完成 。 

基于 MIME 类 型 的 拖 忠 数据 传输 是 基于 QDrag 类 的 。QMimeData 对 
象 将 关联 的 数据 与 其 对 应 的 MIME 类 型 相关 联 。 

百度 百科 : MIME 词 条 

MIME (Multipurpose Internet Mail Extension， 多 用 途 互联 网 邮件 扩 
展 类 型 ) 是 设 定 某 种 扩展 名 的 文件 用 一 种 应 用 程序 来 打开 的 方式 类 型 ， 
当 该 扩展 名 文件 被 访问 时 ， 浏 览 器 会 自动 使 用 指定 的 应 用 程序 来 打开 ， 
多 用 于 指定 一 些 客户 端 自 定义 的 文件 名 ， 以 及 一 些 媒体 文件 打开 方式 。 

每 种 MIME 类 型 都 由 两 部 分 组 成 ， 前 面 是 数据 的 大 类 别 ， 如 声音 
audio、 图 象 image 等 ， 后 面 定 义 具 体 的 种 类 。 

常见 的 MIME 类 型 (通用 型 ) 如 下 : 

e HTML <A .html text/html 

e XML 文档 .xml text/xml 

e XHTML 文档 .xhtml application/xhtml+xml 

o 普通 文本 .txt text/plain 

e RTF XA .rtf application/rtf 

e PDF 文档 .pdf application/pdf 

e Microsoft Word 文 件 .word application/msword 








e PNG 图 像 .png image/png 
e GIF 图 形 .gif image/gif 


e JPEG 图 形 .jpeg、.jpg image/jpeg 

e au 声音 文件 .au audio/basic 

e MIDI 音 乐 文件 .mid、.midi audio/midi,audio/x-midi 

e RealAudio 音 乐 文件 .ra、.ram audio/x-pn-realaudio 

e MPEG 文件 .mpg、.mpeg video/mpeg 

e AVI 文件 .avi video/x-msvideo 

e GZIP 文 件 .gz application/x-gzip 

e TAR 文件 .tar application/x-tar 

e 任意 的 二 进 制 数据 application/octet-stream 

MIME ”类 型 的 数据 可 以 简单 理解 为 互联 网 上 的 各 种 资源 ， 比 如 文 
本 、 音 频 和 视频 资源 等 ， 互 联网 上 的 每 一 种 资源 都 属于 一 种 MIME 类 型 
的 数据 。 

如 表 4-30 所 示 的 MimeData 类 函数 允许 检测 和 使 用 方便 的 MIME 类 
型 。 


表 4-30 


判断 函数 设置 函数 获取 函数 MIME 类 型 


hasImage() imageData() setImageData() image/* 
hasColor() colorData() setColorData() application/x-color 


许多 QWidget XI RELER, OVE HB BLE HIP Ps Ae E. 











QWidget.setDragEnabled() 为 True。 男 外 ， 控 件 应 该 啊 应 拖 忠 事件 ， 以 便 
存储 所 拖 上 忠 的 数据 。 常 用 的 拖 忠 事件 如 表 4-31 所 示 。 


表 4-31 


DragEnterEvent 当 执行 一 个 拖 电 控件 操作 ， 并 且 鼠 标 指针 进入 该 控件 时 ， 这 个 事件 将 被 触发 。 在 这 
个 事件 中 可 以 获得 被 操作 的 窗口 控件 ， 还 可 以 有 条 件 地 接受 或 拒绝 该 拖 电 操作 


DragMoveEvent 在 拖 电 操作 进行 时 会 触发 该 事件 





DragLeaveEvent 当 执 行 一 个 拖 忠 控件 操作 ， 并 且 鼠 标 指针 离开 该 控件 时 ， 这 个 事件 将 被 触发 


当 拖 外 操作 在 目标 控件 上 被 释放 时 ， 这 个 事件 将 被 触发 
案例 4-30 拖 电 功能 


本 例文 件 名 为 PyQt5/Chapter04/qt04_drag.py， 在 PyQt 5 的 窗口 中 演 
ANH ALT AE. HERRE TF: 





super (Example, self). init () 


self.initUI () 


def initUI (self): 
lo = QFormLayout () 
lo.addRow (QLabel ("i748 Z ii LAH 3 Hid 4 FRAP") ) 
edit = QLineEdit () 
edit.setDragEnabled (True) 
com = Combo("Button", self) 
lo.addRow (edit, com) 
self.setLayout (lo) 
self.setWindowTitle (' M Ži 26) ') 


Lf Tane ==! main "s 
app = QApplication(sys.argv) 
ex = Example () 
ex. show () 


sys.exit (app.exec_()) 


运行 脚本 ， 显 示 效 果 如 图 4-47 所 示 。 





n 简单 的 拖 电 例子 一 O E 


请 把 左边 的 文本 拖 搜 到 右边 的 下 拉 菜 单 中 


PyQt5 PyQt5 > 
PyQt5 











图 4-47 


代码 分 析 : 

在 这 个 例子 中 ，DragEnterEvent 会 验证 事件 的 MIME 数 据 是 否 包 含 
字符 串 文 本 ， 如 果 包 含 字 符 串 文本 ， 就 接收 事件 提出 的 添加 文本 操作 ， 
并 将 文本 作为 新 条 目 〈Item) 添加 到 ComboBox 控 件 中 ， 否 则 忽略 此 次 
操作 。 

def dragEnterEvent(self,e): 





if e:mimeData().hasText(): 
e.accept() 
else: 


e.ignore() 


4.11.2 QClipboard 


QClipboard Ape HE Y H AACE MGA AT A], FY DAE A BEA Ta) 3S 
制 和 粘贴 数据 。 它 的 操作 类 似 于 QDrag 类 ， 并 使 用 类 似 的 数据 类 型 。 

QApplication 关 有 一 个 静态 方法 clipboard0， 它 返回 对 剪贴 板 对 象 的 
引用 。 任 何 类 型 的 MimeData 都 可 以 从 剪贴 板 复制 或 粘贴 。 

QClipboard 类 中 的 常用 方法 如 表 4-32 所 示 。 











表 4-32 


清除 剪贴 板 的 内 容 

将 QImage 对 象 复 制 到 前 贴 板 中 

将 MIME 数据 设置 为 前 贴 板 
setPixmap( 从 剪贴 板 中 复制 Pixmap 对 象 
setText( 从 剪贴 板 中 复制 文本 


QClipboard 类 中 的 常用 信号 如 表 4-33 所 示 。 








) 
) 





表 4-33 





dataChanged 当前 贴 板 内 容 发 生变 化 时 ， 这 个 信和 号 被 发 射 


案例 4-31 QClipboard 的 使 用 


本 例文 件 名 为 PyQt5/ Chapter04/qt04_QClipboard.py， 演 示 在 PyQt 5 
的 窗口 中 使 用 QClipboard 控 件 。 其 完整 代码 如 下 : 


def 


def 


def 


def 


def 


imagePasteButton = QPushButton("Paste &Image") 
self.textLabel = QLabel ("Original text") 
self.imageLabel = QLabel () 
self.imageLabel.setPixmap (QPixmap (os.path. join ( 
os.path.dirname(_ file), “images/clock.png") ) ) 
layout = QGridLayout () 

layout.addWidget (textCopyButton, 0, 0) 
layout.addWidget (imageCopyButton, 0, 1) 
layout.addWidget (htmlCopyButton, 0, 2) 
layout.addWidget (textPasteButton, 1, 0) 
layout.addWidget (imagePasteButton, 1, 1) 
layout.addWidget (htmlPasteButton, 1, 2) 
layout.addWidget (self.textLabel, 2, 0, 1, 2) 
layout.addWidget (self.imageLabel, 2, 2) 





self.setLayout (layout) 
textCopyButton.clicked.connect (self.copyText) 
textPasteButton.clicked.connect (self.pasteText) 
htmlCopyButton.clicked.connect (self.copyHtm1) 
html PasteButton.clicked.connect (self.pasteHtml) 
imageCopyButton.clicked.connect (self.copyImage) 
imagePasteButton.clicked.connect (self.pastelImage) 
self.setWindowTitle ("Clipboard 例子 ") 


copyText (self): 
clipboard = QApplication.clipboard() 
clipboard.setText ("I've been clipped!") 


pasteText (self): 
clipboard = QApplication.clipboard() 
self.textLabel.setText (clipboard.text () ) 


copyImage (self): 

clipboard = QApplication.clipboard() 
clipboard.setPixmap (QPixmap (os.path. join ( 
os.path.dirname(_ file ), "./images/python.png") ) ) 


pasteImage (self): 
clipboard = QApplication.clipboard() 


self.imageLabel.setPixmap (clipboard.pixmap () ) 


copyHtml (self): 


mimeData = QMimeData () 


mimeData.setHtml ("<b>Bold and <font color=red>Red</font></b>") 
clipboard = QApplication.clipboard() 
clipboard.setMimeData (mimeData) 


def pasteHtml (self): 
clipboard = QApplication.clipboard() 
mimeData = clipboard.mimeData () 
if mimeData.hasHtml(): 


self.textLabel.setText (mimeData.html () ) 


if _name == T māin ™: 
app = QApplication(sys.argv) 
form = Form() 
form. show () 


sys exit (app -exec (i) 


运行 脚本 ， 显 示 效 果 如 图 4-48 所 示 。 
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图 4-48 


代码 分 析 : 
在 这 个 例子 中 ， 有 6 个 按钮 和 2 个 标签 。 需 要 实例 化 clipboard 对 象 ， 
可 以 将 文本 复制 到 clipboard 对 象 中 。 
clipboard=QApplication.clipboard() 





self.textLabel.setText(clipboard.text()) 
tH AY DAES A Fr E rill BJ BY MG A HT FF 
clipboard=QApplication.clipboard() 








self.imageLabel.setPixmap(clipboard.pixmap()) 


y 


4.12 村 的 旧 


4.12.1 QCalendar 


QCalendar 是 一 个 日 历 控件 ， 它 提供 了 一 个 基于 月 份 的 视图 ， 人 允许 
用 户 通过 鼠标 或 键盘 选择 日 期 ， 默 认 选 中 的 是 今天 的 日 期 。 也 可 以 对 日 
历 的 日 期 范围 进行 规定 。 

QCalendar 类 中 的 常用 方法 如 表 4-34 所 示 。 





表 4-34 


设置 日 期 范围 供 选择 
setFirstDayOfWeek() 重新 设置 星期 的 第 一 天 ， 默 认 是 星期 日 。 其 参数 枚 举 值 如 下 : 
© Qt.Monday， 星 期 一 
。Qt.Tuesday， 星 期 二 
。 Qt.Wednesday， 星 期 三 
。 Qt.Thursday， 星 期 四 
。 Qt.Friday， 星 期 五 
。 Qt.Saturday， 星 期 六 
。 Qt.Sunday， 星 期 日 
设置 一 个 QDate 对 象 ， 作 为 日 期 控件 所 选 定 的 日 其 
获取 日 历 控件 的 最 大 日 其 
获取 日 历 控件 的 最 小 日 其 
返回 当前 选 定 的 日 其 
设置 日 历 控件 是 否 显示 网 格 


案例 4-32 QCalendar 的 使 用 


本 例文 件 名 为 PyQt5/Chapter04/qt04_QCalendar.py， 演 示 在 PyQt 5 
的 窗口 中 使 用 QCalendar 控 件 。 其 完整 代码 如 下 : 








运行 脚本 ， 显 示 效 果 如 图 4-49 所 示 。 
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图 4-49 


代码 分 析 : 
在 这 个 例子 中 有 日 历 控件 和 标签 控件 ， 当 前 选 定 的 日 期 显示 在 标签 
控件 中 。 
以 下 代码 创建 了 QCalendarWidget 组 件 ， 并 设置 该 日 历 控件 的 最 大 
日 期 和 最 小 日 期 。 
self.cal=QCalendarWidget(self) 
self.cal.setMinimumDate(QDate(1980,1,1)) 
self.cal.setMaximumDate(QDate(3000,1,1)) 
从 窗口 组 件 中 选 定 一 个 日 期 ， 会 发 射 一 个 QCore.QDate 信 号 ， 下 面 
代码 将 此 信号 连接 到 用 户 定 义 的 showDate() 权 函数 。 
self.cal.clicked[QtCore.QDate].connect(self.showDate) 








接 下 来 ， 通 过 调用 selectedDate0) 方 法 检索 所 选 定 的 日 期 ， 然 后 将 日 
期 对 象 转换 为 指定 格式 字符 串 并 将 其 设置 为 标签 控件 内 容 。 
def showDate(self, date): 
self.lbl.setText(date.toString("yyyy-MM-dd dddd") ) 


4.12.2 QDateTimeEdit 


QDateTimeEdit 是 一 个 允许 用 户 编辑 日 期 时 间 的 控件 ， 可 以 使 用 键 
盘 和 上 、 下 稍 头 按钮 来 增加 或 减少 日 期 时 间 值 。 比 如 ， 当 使 用 鼠标 选中 
QDateTimeEdit 中 的 年 份 时 ， 可 以 使 用 键盘 上 的 上 、 下 键 来 改变 数值 ， 
如 图 4-50 和 图 4-51 所 示 。 
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图 4-50 
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图 4-51 


QDateTimeEdit 通 过 setDisplayFormat() 函 数 来 设置 显示 的 日 期 时 间 格 
Ths 





QDateTimeEdit 类 中 的 常用 方法 如 表 4-35 所 示 。 


表 4-35 
方 3 描述 





setDisplayFormat() 设置 日 期 时 间 格 式 : 
e yyyy, RREH M 4 位 数 表示 
。MM， 代 表 月 份 ， 取 值 范 围 为 01~12 
edd， 代 表 日 ， 取 值 范围 为 01~31 
。HH， 代 表 小 时 ， 取 值 范围 为 00~23 


emm， 代 表 分 钟 ， 取 值 范围 为 00~59 
。 ss， 代 表 秒 ， 取 值 范 围 为 00~59 


设置 控件 的 最 小 日 其 
设置 控件 的 最 大 日 其 


QDateTimeEdit 类 中 的 党 用 信号 如 表 4-36 所 示 。 





表 4-36 


dateChanged 当日 期 改变 时 发 射 此 信号 
dateTimeChanged 当日 期 时 间 改 变 时 发 射 此 信号 








timeChanged 当时 间 改 变 时 发 射 此 信号 
1.QDateTimeEdit 的 子 类 
QDateEdit 和 QTimeEdit 类 均 继 承 自 QDateTimeEdit 类 ， 它 们 的 许多 特 
性 和 功能 都 由 QDateTimeEdit 类 提供 。QDateEdit 和 QTimeEdit 类 的 继承 结 
构 如 下 : 


QWidget 
| 
+- QAbstractSpinBox 
| 


+- QDateTimeEdit 
aa QDateEdit 
a QTimeEdit 

设置 显示 格式 时 要 注意 : QDateEdit 用 来 编辑 控件 的 日 期 ， 仅 包括 
年 、 月 和 日 ,QTimeEdit 用 来 编辑 控件 的 时 间 ， 仪 包括 小 时 、 分 钟 和 
秒 。 

不 要 用 QDateEdit 来 设置 或 获取 时 间 ， 也 不 要 用 QTimeEdit 来 设置 或 
获取 日 期 。 如 果 要 同时 操作 日 期 时 间 ， 请 使 用 QDateTimeEdit。 使 用 它 
们 设置 显示 格式 的 正确 方法 如 下 : 

dateEdit=QDateEdit( self) 
timeEdit=QTimeEdit(self) 
dateEdit.setDisplayFormat("yyyy-MM-dd") 
timeEdit.setDisplayFormat("HH:mm:ss") 

设置 弹出 日 历时 要 注意 : 用 来 弹出 日 历 的 类 只 有 QDateTimeEdit 和 
QDateEdit， 而 QTimeEdit 类 虽然 在 语法 上 可 以 设置 弹出 日 历 ， 但 不 起 
作用 。 使 用 它们 弹出 日 历 的 正确 方法 如 下 : 

dateTimeEdit=QDateTimeEdit(self) 
dateEdit=QDateEdit(self) 
dateTimeEdit.setCalendarPopup(True) 





dateEdit.setCalendarPopup(True) 

2. 初 始 化 QDateTimeEdit 类 

在 默认 情况 下 ， 如 果 QDateTimeEdit 类 构造 时 不 指定 日 期 时 间 ， 那 
么 系统 会 为 其 设置 一 个 和 本 地 相同 的 日 期 时 间 格 式 ， 并 且 值 为 2000 年 1 





月 1 日 ”0 时 0 分 0 秒 。 也 可 以 手动 指定 控件 显示 的 日 期 时 间 。 本 例文 件 名 

为 PyQt5/Chapter04/gt04_QDateTimeEdit01.py， 其 核心 代码 如 下 : 
dateTimeEdit=QDateTimeEdit(self) 
dateTimeEdit2=QDateTimeEdit(QDateTime.currentDateTime(),self) 
dateEdit=QDateTimeEdit(QDate.currentDate(),self) 
timeEdit=QDateTimeEdit(QTime.currentTime(),self) 


显示 效果 如 图 图 4-52 所 示 。 
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图 4-52 





除 通 过 构造 函数 指定 所 显示 的 日 期 时 间 外 ， 也 可 以 根据 
QDateTimeEdit ”提供 的 槽 函数 来 设置 ， 比 如 setDateTime(O、setDate()、 
setTime() K XL. 

3. 设 置 日 期 时 间 格 式 

如 果 不 想 使 用 系统 默认 的 格式 ， 则 可 以 通过 setDisplayFormat()*K A 
定义 日 期 时 间 格 式 。 

dateTimeEdit=QDateTimeEdit(self) 
dateTimeEdit2=QDateTimeEdit(QDateTime.currentDateTime(),self) 
dateEdit=QDateTimeEdit(QDate.currentDate(),self) 
timeEdit=QDateTimeEdit(QTime.currentTime(),self) 

# 设置 日 期 时 间 格 式 


dateTimeEdit.setDisplayFormat("yyyy-MM-dd HH:mm:ss") 
dateTimeEdit2.setDisplayFormat("yyyy/MM/dd HH-mm-ss" 
dateEdit.setDisplayFormat("yyyy.MM.dd") 
timeEdit.setDisplayFormat("HH:mm:ss") 

显示 效果 如 图 4-53 所 示 。 
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4. 设 置 日 期 时 间 范 
下 面 代码 创建 了 QDateTimeEdit 对 象 ， 并 设置 日 期 时 间 为 今天 
CcurrentDate) ， 同 时 限制 有 效 日 期 的 范围 为 : 距离 今天 +365 天 。 

dateEdit=QDateTimeEdit(QDateTime.currentDateTime(),self) 
dateEdit.setDisplayFormat("yyyy-MM-dd HH:mm:ss") 
# 设置 最 小 日 期 
dateEdit.setMinimumDate(QDate.currentDate().addDays(-365)) 
# 设置 最 大 日 期 
dateEdit.setWaximumDate(QDate.currentDate().addDays(365)) 

5. 弹 出 日 历 

在 默认 情况 下 ， 只 能 通过 上 下 箭头 来 改变 日 期 时 间 。 如 采 要 弹出 日 

历 控 件 ， 只 需 调 用 setCalendarPopup(True) 即 可 。 





dateEdit=QDateTimeEdit(QDateTime.currentDateTime(),self) 

dateEdit.setMinimumDate(QDate.currentDate().addDays(-365)) 

dateEdit.setWMaximumDate(QDate.currentDate().addDays(365)) 

dateEdit.setCalendarPopup( True) 

显示 效果 如 图 4-54 所 示 。 

从 图 4-54 可 以 看 出 ， 单 击 下拉 箭 头 就 会 弹出 日 历 控件 。 注 意 : 由 于 
设置 了 日 期 范围 ， 所 以 不 在 范围 内 的 日 期 是 无 法 选择 的 。 
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6. 获 取 日 期 时 间 

可 以 通过 date()、dateTime() 等 方法 来 获取 日 期 时 间 对 象 ， 如 果 要 获 
取 年 、 月 、 日 等 信息 ， 则 可 以 调用 QDate 的 year()、month()、day0 等 函 
数 。 


dateTime=self.dateEdit.dateTime() 


# 最 大 日 期 
max Date=self.dateEdit.maximumDate() 
# 最 大 日 期 时 间 
maxDateTime=self.dateEdit. maximumDateTime() 
# 最 大 时 间 
max Time=self.dateEdit.maximumTime() 
# 最 小 日 期 
minDate=self.dateEdit.minimumDate() 
# 最 小 日 期 时 间 
minDateTime=self.dateEdit.minimumDateTime() 
# 最 小 时 间 
minTime=self.dateEdit.minimumTime() 
print(\n 选 择 日 期 时 间 ' ) 
print(‘'dateTime=%s' % str(dateTime) ) 
print(‘maxDate=%s' % str(maxDate) ) 
print(‘maxDateTime=%s' % str(maxDateTime) ) 
print(‘maxTime=%s' % str(maxTime) ) 
print(‘minDate=%s' % str(minDate) ) 
print(‘minDateTime=%s' % str(minDateTime) ) 
print(‘minTime=%s' % str(minTime) ) 

输出 结果 如 下 : 
选择 日 期 时 间 
dateTime=PyQt5.QtCore.QDateTime(2017,5,1,17,41,22,441) 
maxDate=PyQt5.QtCore.QDate(2018,5,13) 
maxDateTime=PyQt5.QtCore.QDateTime(2018,5,13,23,59,59,999) 
maxTime=PyQt5.QtCore.QTime(23,59,59,999) 
minDate=PyQt5.QtCore.QDate(2016,5,13) 


minDateTime=PyQt5.QtCore.QDateTime(2016,5,13,0,0) 
minTime=PyQt5.QtCore.QTime(0,0) 
7. 信 号 和 覃 函数 
QDateTimeEdit 控件 常用 的 信号 是 dateChanged、dateTimeChanged 
和 timeChanged， 分 别 在 改变 日 期 、 日 期 时 间 、 时 间 时 发 射 。 
通过 以 下 代码 设置 控件 的 信号 连接 槽 函数 。 
dateEdit.dateChanged.connect(self.onDateChanged) 
dateEdit.dateTimeChanged.connect(self.onDateTimeChanged) 
dateEdit.timeChanged.connect(self.onTimeChanged) 
槽 函数 如 下 : 
# 日 期 发 生 改 变 时 执行 
def onDateChanged(self ,date): 
print(date) 
# 无 论 是 日 期 还 是 时 间 发 生 改 变 时 都 会 执行 
def onDateTimeChanged(self ,dateTime ): 
print(dateTime) 
# 时 间 发 生 改 变 时 执行 
def onTimeChanged(self ,time): 


print(time) 


案例 4-33 QDateTimeEdit 的 使 用 
本 例文 件 名 为 PyQt5/Chapter04/qt04_QDateTimeEdit02.py， 演 示 在 
PyQt 5 的 窗口 中 使 用 QDateTimeEdit 控 件 。 其 完整 代码 如 下 : 


super (DateTimeEditDemo, self). init  () 
self.initUI () 


def initUI (self): 
self.setWindowTitle('QDateTimeEdit 例子 ') 


self.resize(300, 90) 


vlayout = QVBoxLayout () 
self.dateEdit = QDateTimeEdit (QDateTime.currentDateTime(), 
self) 
self.dateEdit.setDisplayFormat ("yyyy-MM-dd HH:mm:ss") 
# 设置 最 小 日 期 
self.dateEdit.setMinimumDate ( 
QDate.currentDate() .addDays (-365) ) 


# 设置 最 大 日 期 
self.dateEdit.setMaximumDate ( 
QDate.currentDate() .addDays (365) ) 
self.dateEdit.setCalendarPopup( True) 


self.dateEdit.dateChanged.connect (self.onDateChanged) 
self.dateEdit.dateTimeChanged.connect (self.onDateTimeChanged) 


self.dateEdit.timeChanged.connect (self.onTimeChanged) 


self.btn = QPushButton(' 获 得 日 期 和 时 间 ') 


self.btn.clicked.connect (self.onButtonClick) 





vlayout.addWidget( self.dateEdit ) 
vlayout.addWidget( self.btn ) 
self.setLayout (vlayout) 


+ 日 期 发 生 改 变 时 执行 
def onDateChanged(self , date): 
print (date) 


# 无 论 是 日 期 还 是 时 间 发 生 改 变 时 都 会 执行 
def onDateTimeChanged(self , dateTime ) : 
print (dateTime) 


# 时 间 发 生 改 变 时 执行 
def onTimeChanged(self , time): 
print (time) 


def onButtonClick(self ): 


dateTime = self.dateEdit.dateTime() 


# 了 最 大 日 期 

maxDate = self.dateEdit.maximumDate () 

# 最 大 日 期 时 间 

maxDateTime = self.dateEdit.maximumDateTime () 
# 最 大 时 间 

maxTime = self.dateEdit.maximumTime () 

# 最 小 日 期 

minDate = self.dateEdit.minimumDate () 

# 最 小 日 期 时 间 

minDateTime = self.dateEdit.minimumDateTime () 
# 最 小 时 间 


minTime = self.dateEdit.minimumTime () 


print ('\n 选择 日 期 时 间 ' ) 

print ('dateTime=%s' % str(dateTime) ) 

print ('maxDate=%s' % str(maxDate) ) 

print ('maxDateTime=%s' % str(maxDateTime) ) 
print ('maxTime=%s' % str(maxTime) ) 

print ('minDate=%s' % str(minDate) ) 


print ('minDateTime=%s' % str(minDateTime) ) 


print ('minTime=%s' % str(minTime) ) 
if _ name == ' main '": 
app = QApplication(sys.argv) 
demo = DateTimeEditDemo () 


demo. show () 
sys.exit (app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 4-55 所 示 。 
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代码 分 析 : 

在 这 个 例子 中 有 QDateTimeEdit 控件 和 按钮 控件 ， 当 单 击 “ 获 得 日 
期 和 时 间 ” 按 钮 时 ， 会 获得 当前 的 日 期 和 时 间 。 设 置 QDateTimeEdit 日 
期 时 间 格 式 的 核心 代码 如 下 。 

self.dateEdit.setDisplayFormat("yyyy-MM-dd HH:mm:ss") 





4.13.1 菜单 栏 


在 QMainWindow 对 象 的 标题 栏 下 方 ， 水 平 的 QMenuBar 被 保留 显示 
QMenu 对 象 。 

QMenu 类 提供 了 一 个 可 以 添加 到 过 单 栏 的 小 控件 ， 也 用 于 创建 上 下 
文 束 单 和 弹出 染 单 。 每 个 QMenu 对 象 都 可 以 包含 一 个 或 多 个 QAction 对 
象 或 级 联 的 QMenu 对 象 。 

要 创建 一 个 弹出 表单 ，PyQt API 提供 了 createPopupMenu0 函 数 ; 
menuBar(0) 函 数 用 于 返回 主 窗口 的 QMenuBar 对 象 ，addMenu() 函 数 可 以 
将 菜单 添加 到 菜单 栏 中 ; 通过 addAction() 函 数 可 以 在 菜单 中 进行 添加 操 
{Fs 





在 设计 沫 单 系统 时 使 用 的 一 些 重 要 方法 如 表 4-37 所 示 。 


表 4-37 


在 菜单 栏 中 添加 一 个 新 的 QMenu 对 象 

向 QMenu 小 控件 中 添加 一 个 操作 按钮 ， 其 中 包含 文本 或 图 标 
setEnabled() 将 操作 按钮 状态 设置 为 启用 /禁用 
addSeperator() 在 菜单 中 添加 一 条 分 隔 线 





clear() 删除 菜单 /菜单 栏 的 内 容 
setShortcut() 将 快捷 键 关 联 到 操作 按钮 
设置 菜单 项 的 文本 
设置 QMenu 小 控件 的 标题 
返回 与 QAction 对 象 关联 的 文本 
返回 QMenu 小 控件 的 标题 


单 击 任何 QAction 按 钮 时 ，QMenu 对 象 都 会 发 射 triggered 信 号 。 








案例 4-34 QMenuBar $ 


本 例文 件 名 为 PyQt5/Chapter04/qt0414_Qmenu.py， 演 示 在 PyQt 5 的 
窗口 中 使 用 QMenuBar、QMenu 和 QAction。 其 完整 代码 如 下 : 


import sys 

from PyQt5.QtCore import * 
Etrom PyQrES.OtGua rmport = 
from PyOt5.QtWidgets import * 





运行 脚本 ， 显 示 效 果 如 图 4-56 所 示 。 
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图 4-56 


代码 分 析 : 
在 这 个 例子 中 ， 顶 层 窗口 必须 是 QMainWindow 对 象 ， 才 可 以 引用 
QMenuBar 对 象 。 

通过 addMenu(0) 方 法 将 “File” 荣 单 添 加 到 菜单 栏 中 。 
bar=self.menuBar() 
file=bar.addMenu("File") 

琳 单 中 的 操作 按钮 可 以 是 字符 串 或 QAction 对 象 。 
file=bar.addMenu("File") 
file.addAction("New") 
save=QAction("Save",self) 
save.setShortcut("Ctrl+S") 
file.addAction(save) 

KEP SE LYS TIM BTR SE AH 


edit=file.addMenu("Edit") 
edit.addAction("copy") 
edit.addAction("paste") 
菜单 发 射 tiggered 信 号 ， 将 该 信号 连接 到 槽 函数 proecesstigger0)， 
该 函数 接收 信号 的 QAction 对 象 。 
file.triggered[QAction].connect(self.processtrigger) 





4.13.2 OToolBar 





QToolBar 控 件 是 由 文本 按钮 、 图 标 或 其 他 小 控件 按钮 组 成 的 可 移动 
面板 ， 通 党 位 于 菜单 栏 下 方 。 
QToolBar 类 中 的 第 用 方法 如 表 4-38 所 未 。 





表 4-38 


添加 具有 文本 或 图 标的 工具 按钮 

addSeperator() 分 组 显示 工具 按钮 

addWidget() 添加 工具 栏 中 按钮 以 外 的 控件 

addToolBar() 使 用 QMainWindow 类 的 方法 添加 一 个 新 的 工具 栏 
[ 具 栏 变 得 可 移动 
工具 栏 的 方向 可 以 设置 为 Qt.Horizontal 或 Qt.vertical 


每 当 单 击 工具 栏 中 的 按钮 时 ， 都 将 发 射 actionTriggered 信号 。 另 
外 ， 这 个 信号 将 关联 的 QAction 对 象 的 引用 发 送 到 连接 的 槽 函数 上 。 
案例 4-35 QToolBar 的 使 用 
本 例文 件 名 为 PyQt5/Chapter04/qt0415_QToolBar.py， 演 示 在 PyQt 5 
的 窗口 中 使 用 QToolBar。 其 完整 代码 如 下 : 























运行 脚本 ， 显 示 效 果 如 图 4-57 所 示 。 


a toolbar 例 子 一 myx 
> a 











图 4-57 


代码 分 析 : 
在 这 个 例子 中 ， 首 先 调 用 addToolBar() 方 法 在 工具 栏 区 域 添加 文件 
TAR. 
tb=self.addToolBar("File") 
然后 ， 添 加 具有 文本 标题 的 工具 按钮 ， 工 具 栏 通常 包含 图 形 按钮 。 
具有 图 标 和 名 称 的 QAction 对 象 将 被 添加 到 工具 栏 中 。 


new=QAction(QIcon("./images/new.png"),"new", self) 








tb.addAction(new) 
open=QAction(QIcon("./images/open.png"),"open", self) 
tb.addAction(open) 
save=QAction(QIcon("./images/save.png"),"save",self) 
tb.addAction(save) 

Ha, ‘factionTriggered{a mié f% FI eX Btoolbtnpressed(). 
tb.actionTriggered[QAction].connect(self.toolbtnpressed) 


4.13.3 QStatusBar 


MainWindow 对 象 在 底部 保留 有 一 个 水 平 条 ， 作 为 状态 栏 
(QStatusBar) ， 用 于 显示 永久 的 或 临时 的 状态 信息 。 
通过 主 窗口 的 QMainWindow 的 setStatusBar0 函 数 设置 状态 栏 ， 核 心 
代码 如 下 : 
self.statusBar=QStatusBar() 
self.setStatusBar(self.statusBar) 
QStatusBar 类 中 的 常用 方法 如 表 4-39 所 示 。 





表 4-39 


addWidget() 在 状态 栏 中 添加 给 定 的 窗口 小 控件 对 象 
addPermanentWidget() 在 状态 栏 中 永久 添加 给 定 的 窗口 小 控件 对 象 


A ”法 描 述 
showMessage() 在 状态 栏 中 显示 一 条 临时 信息 指定 时 间 间 隔 





续 表 





clearMessage() 删除 正在 显示 的 临时 信息 


removeWidget() 从 状态 栏 中 删除 指定 的 小 控件 


案例 4-36 QStatusBar 的 使 用 
本 例文 件 名 为 PyQt5/Chapter04/qt04_QStatusBar.py， 演 示 在 PyQt 5 
的 窗口 中 使 用 QStatusBar 控 件 。 其 完整 代码 如 下 : 








运行 脚本 ， 显 示 效 果 如 图 4-58 所 示 。 


m’ QStatusBar 例子 一 = x 
File 
| 


show FAAA Ais S 
图 4-58 


代码 分 析 : 
在 这 个 例子 中 ， 顶 层 窗口 “MainWindow ”有 一 个 菜单 栏 和 一 个 
QTextEdit 对 象 ， 作 为 中 心 控 件 。 
当 单 击 MenuBar 的 菜单 时 ， 将 triggered 信 号 与 槽 函数 processTrigger() 
进行 绑 定 。 
file.triggered[QAction].connect(self.processTrigger) 
当 单 击 “show” 沫 单 选项 时 ， 会 在 状态 栏 显示 提示 信息 ， 并 在 5 秒 后 
HRe 
if (q.textQ=="show"): 
self.statusBar.showMessage(q.text()+" 菜单 选项 被 单 击 了",5000) 














4.14 QPrinter 


打印 图 像 是 图 像 处 理 软件 中 的 一 个 第 用功 能。 打印 图 像 实 际 上 是 在 
QPaintDevice 中 画图 ， 与 平常 在 QWidget、QPixmap 和 QImage 中 画图 一 
样 ， 都 是 创建 一 个 ”QPainter ”对 象 进行 画图 的 ， 只 是 打印 使 用 的 是 
QPrinter， 它 本 质 上 也 是 一 个 QPaintDevice (绘图 设备 ) 。 


案例 4-37 QPrinter 的 使 用 


本 例文 件 名 为 PyQt5/Chapter04/qt04_painter.py， 演 示 使 用 QPrinter 
打印 图 片 的 功能 。 其 完整 代码 如 下 : 


from PyQt5.QtGui import QImage , QIcon, QPixmap 

from PyQt5.QtWidgets import QApplication , QMainWindow, QLabel, 
QSizePolicy , QAction 

from PyQt5.QtPrintSupport import QPrinter, QPrintDialog 


import sys 


class MainWindow (QMainWindow) : 
def init. (self,parent=None) : 
super (MainWindow,self). init (parent) 
self.setWindowTitle (self.tr(" 打 印 图 片 ")) 
self.imageLabel=QLabel () 
self.imageLabel.setSizePolicy ( 
QSizePolicy. Ignored, QSizePolicy.Ignored) 
self.setCentralWidget (self.imageLabel) 
self .image=QImage () 
self.createActions () 
self.createMenus () 


self.createToolBars () 


if self.image.load("./images/screen.png") : 
self.imageLabel.setPixmap (QPixmap. fromimage (self.image) ) 


self.resize(self.image.width(),self.image.height () ) 


def createActions (self): 
self.PrintAction=QAction ( 
QIcon("./images/printer.png"), 
self.tr("4FP"), 
self ) 
self.PrintAction.setShortcut ("Ctrl+P") 
self.PrintAction.setStatusTip(self.tr("47FP") ) 


self.PrintAction.triggered.connect (self.slotPrint) 


def createMenus (self): 
PrintMenu=self.menuBar() .addMenu(self.tr("47FP") ) 


PrintMenu.addAction (self. PrintAction) 


def createToolBars (self): 
fileToolBar=self.addToolBar ("Print") 
fileToolBar.addAction(self.PrintAction) 


def slotPrint (self): 
printer=QPrinter () 
printDialog=QOPrintDialog (printer, self) 
if printDialog.exec (): 
painter=QPainter (printer) 
rect=painter.viewport () 
size=self.image.size() 


size.scale(rect.size(),Qt.KeepAspectRatio) 


painter.setViewport (rect.x(),rect.y(),size.width(), 
size.height ()) 

painter.setWindow(self.image.rect () ) 

painter.drawImage (0,0,self.image) 


slic’ Soleus) Soe n mann Me 
app=QApplication(sys.argv) 
main=MainWindow () 
main. show () 


sys.exit(app.exec_()) 


运行 脚本 ， 显 示 效 果 如 图 4-59 和 图 4-60 所 示 。 
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3.1 =j 


表格 与 树 解决 的 问题 是 如 何在 一 个 控件 中 有 规律 地 呈现 更 多 的 数 
据 。PyQt 提 供 了 两 种 控件 类 用 于 解决 该 问题 ， 其 中 一 种 是 表格 结构 的 控 
件 类 ;， 男 一 种 是 树 形 结构 的 控件 类 。 


5.1.1 QTableView 


在 通常 情况 下 ， 一 个 应 用 需要 和 一 批 数据 〈 比 如 数组 、 列 表 ) 进行 
交互 ， 然 后 以 表格 的 形式 输出 这 些 信息 ， 这 时 就 要 用 到 QTableView 类 
Jo Œ QtableView ”中 可 以 使 用 自 定 义 的 数据 模型 来 显示 内 容 ， 通 过 
setModel 来 绑 定 数据 源 。 

QTableView 类 的 继承 结构 如 图 5-1 所 示 。 


QAbstractScrollArea 


cza QLabel 


QLCDNumber 


QAbstractitemView 


QGraphicsView 
QMdiArea 
QPlainTextEdit 
QScrollArea 
QTextEdit 


PyQts.QtWidgets.QSplitte 


QStackedWidget 


QToolBox 


图 5-1 


QCcolumnView 

QHeaderView 

QListView 

QTableView — QTableWidget 
QTreeView 


QTableWidget 继 承 自 QTableView， 主 要 区 别 是 QTableView 可 以 使 
用 上 自 定义 的 数据 模型 来 显示 内 容 〈 先 要 通过 setModel 来 绑 定 数据 源 ) ， 
而 QTableWidget “只 能 使 用 标准 的 数据 模型 ， 并 且 其 单元 格 数据 是 通过 
QTableWidgetItem 对 象 来 实现 的 。 通 常 使 用 QTableWidget 束 能 够 满足 我 


们 的 要 求 。 


QTableView 控 件 可 以 绑 定 一 个 模型 数据 用 来 更 新 控件 上 的 内 容 ， 可 


用 的 模式 如 表 5-1 所 示 。 


QStringListModel 
QStandardItemModel 
QDirModel 


存储 一 组 字符 串 
存储 任意 层次 结构 的 数据 
对 文件 系统 进行 封装 





QSqlQueryModel 


QSqlTableModel 
QSqlRelationalTableModel 


对 SQL 的 查询 结果 集 进行 封装 
对 SQL 中 的 表格 进行 封装 
对 带 有 foreign key 的 SQL 表格 进行 封装 





QSortFilterProxyModel 








对 模型 中 的 数据 进行 排序 或 过 滤 


案例 5-1 QTableView 的 使 用 
本 例文 件 名 为 PyQt5/Chapter05/qt05_tblViewModel.py， 其 完整 代码 
OF: 


from PyQt5.QtWidgets import * 
from PyQt5.QtGui import * 
from PyOQt5.QtCore import * 


import sys 
class Table (QWidget): 


def init (self, arg=None): 
super (Table, self). init _ (arg) 
self.setWindowTitle ("QTableView 表格 视图 控件 的 例子 ") 
self.resize(500, 300); 
self .model=QStandardItemModel (4,4); 
self.model.setHorizontalHeaderLabels (['#hA1', "FRM 2', FRM 
3',' 标 题 4']) 


for row in range (4) : 
for column in range(4): 


item = QStandarditem("row %s, column %s"% (row, column) ) 


self.model.setItem(row, column, item) 


self.tableView=OTableView () 
self.tableView.setModel (self.model) 


dlgLayout=OQVBoxLayout () ; 
digLayout.addWidget (self.tableView) 
self.setLayout (dlgLayout) 


if name ==" main _': 
app = QApplication(sys.argv) 
table = Table() 
table.show () 


sys.exit (app.exec_ ()) 


运行 脚本 ， 显 示 效 果 如 图 5-2 所 示 。 





标题 2 标题 3 标题 


1 row 0, column 0 row 0, column 1 row 0, column 2 row 0, coll 


2 row 1, column 0 row 1, column 1 row 1, column 2 row 1, coll 


3 row 2, column 0 row 2, column 1 row 2, column 2 row 2, coll 


4 row 3, column 0 row 3, column 1 row 3, column 2 row 3, colt 














图 5-2 





从 图 5-2 可 以 看 出 ， 表 格 并 没有 填 满 窗口 ， 每 列 可 以 自由 拉动 ， 但 
是 可 能 会 出 现 滚动 条 。 

(1) 需要 表格 填 满 窗口 ， 可 以 添加 下 面 代码 。 
self.tableView.horizontalHeader().setStretchLastSection(True) 
self.tableView.horizontalHeader().setSectionResize Mode(QHeaderVie 

retch) 

(2) 添加 数据 。 
self.model.appendRow([ 

QStandardItem("row %s,column %s"%(11,11)), 
QStandardItem("row %s,column %s"%(11,11)), 
QStandardItem("row %s,column %s"%(11,11)), 
QStandardItem("row %s,column %s"%(11,11)), 


]) 
C3) 删除 当前 选中 的 数据 。 


# 取 当前 选中 的 所 有 行 


indexs=self.table View.selectionModel().selection().indexes() 
if len(indexs) > 0: 
# 取 第 一 行 的 索引 
index=indexs[0] 
self.model.removeRows(index.row(),1) 
第 二 种 方法 : 
index=self.tableView.currentIndex() 
print(index.row()) 
self.model.removeRow(index.row()) 
如 果 在 表格 中 什么 也 不 选 ， 那 么 默认 删除 的 是 第 一 行 ， 也 就 是 索引 
为 0 的 行 ， 选 中 一 行 时 就 删除 这 一 行 ， 选 中 多 行 时 ， 如 采 焦 点 在 最 后 一 
行 ， 就 删除 这 一 行 。 


5.1.2 QListView 


QListView 类 用 于 展示 数据 ， 它 的 子 类 是 QListWidget。QListView 
是 基于 模型 (Model) 的 ， 需 要 程序 来 建立 模型 ， 然 后 再 保存 数据 。 

QListWidget 是 一 个 升级 版 本 的 QListView， 它 已 经 建立 了 一 个 数据 
存储 模型 (QListWidgetItem) ， 直 接 调 用 addItem() 函 数 ， 就 可 以 添加 条 
H (Item) 。 


QListView 类 中 的 常用 方法 如 表 5-2 所 示 。 








表 5-2 


setModel() 用 来 设置 View 所 关联 的 Model, 可 以 使 用 Python 原生 的 list 作为 数据 源 


Model 
selectedItem() 选中 Model 中 的 条 目 


isSelected() 判断 Model 中 的 某 条 目 是 否 被 选中 


QListView 类 中 的 常用 信号 如 表 5-3 所 示 。 





表 5-3 





案例 5-2 QListView 的 使 用 


本 例文 件 名 为 PyQt5/Chapter05/qt05_listView.py， 演 示 在 PyQt 5 的 
窗口 中 使 用 QListView 控 件 。 其 完整 代码 如 下 : 


from PyQt5.QtWidgets import QApplication, QWidget , QVBoxLayout , 
QListView, QMessageBox 
from PyQt5.QtCore import QStringListModel 


import sys 


class ListViewDemo (QWidget) : 
def init (self, parent=None) : 
super (ListViewDemo, self). init (parent) 
self.setWindowTitle("QListView 例子 ") 
self.resize(300, 270) 
layout = QVBoxLayout () 


listView = QListView() 

slm = QStringListModel (); 

self.gList.= ['Item 1", 'Item 2','Item 3', 'Item 4' ] 
slm.setStringList (self.qList) 

listView.setModel(slm ) 

listView.clicked.connect (self.clicked) 
layout.addWidget( listView ) 

self.setLayout (layout) 


def clicked(self, qModelIndex): 
QMessageBox.information(self, "ListWidget", "itd: "+ 


self.qList [qModelIndex.row() ]) 


" Ww. 


if _ name ==" main "r 


app = QApplication(sys.argv) 
win = ListViewDemo () 
win. show () 


sys.exit(app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 5-3 所 示 。 

在 这 个 例子 中 ， 当 单 击 QListView 控 件 里 Model 中 的 一 项 时 会 弹出 消 
恩 框 (提示 选择 的 是 哪 一 项 )。 

将 QListView 控 件 的 dicked 信 号 与 自 定义 对 象 的 clicked0 模 函数 进行 
绑 定 。 


listView.clicked.connect(self.clicked) 


mi QListView 例子 一 O 


Item 1 
Item 2 
Item 3 
Item 4 











图 5-3 
5.1.3 QListWidget 


QListWidet 类 是 一 个 基于 条 目的 接口 ， 用 于 从 列表 中 添加 或 删除 条 
目 。 列 表 中 的 每 个 条 目 都 是 一 个 QListWidgetItem 对 象 。QListWidget 可 
以 设置 为 多 重 选 择 。 

QListWidget 类 中 的 第 用 方法 如 表 5-4 所 示 。 








addItem() 在 列表 中 添加 QListWidgetltem 对 象 或 字符 串 





QListWidget 类 中 的 常用 信号 如 表 5-5 所 示 。 


表 5-5 


= RAE HARE RGA 





itemClicked 当 点 击 列表 中 的 条 目 时 发 射 此 信和 号 


案例 5-3 QListWidget 的 使 用 
本 例文 件 名 为 PyQt5/Chapter05/qt05_QListWidget.py， 演 示 在 PyQt 5 
的 窗口 中 使 用 QListWidget 控 件 。 其 完整 代码 如 下 : 


import sys 
from PyQt5.QtCore import * 


from PyQt5.QtGui import * 
from PyOt5.QtWidgets import * 


class ListWidget (QListWidget) : 
def clicked(self,item): 
QMessageBox.information(self, "ListWidget", "SKik#T: 


"+item.text ()) 


if name == ' main ': 

app = QApplication(sys.argv) 
listWidget = ListWidget () 
listWidget.resize (300,120) 
listWidget.addItem("Item 1"); 
listWidget.addItem("Item 2"); 
listWidget.addItem("Item 3"); 
listWidget.addItem("Item 4"); 
listWidget.setWindowTitle('QListwidget 例子 ') 
listWidget.itemClicked.connect (listWidget.clicked) 





listWidget. show () 


sys.exit (app.exec_()) 


运行 脚本 ， 显 示 效 果 如 图 5-4 所 示 。 


m? Qlistwidget... 一 © 


‘Item 1 


Item 2 L ListWidget EJ 
Item 3 
Item 4 oO 你 选择 了 : Item 3 


OK 











图 5-4 


代码 分 析 : 
在 这 个 例子 中 ， 当 单 击 QListWidget 列表 中 的 一 个 条 目 时 会 弹出 消 
恩 框 ， 提 示 选 择 的 是 哪个 条 目 。 
将 QListWidget 控 件 的 itemClicked 信 号 与 自 定义 对 象 的 Clicked0 槽 函 
数 进 行 绑 定 。 
listWidget.itemClicked.connect(listWidget.Clicked) 


5.1.4 QTableWidget 


QTableWidget 是 Qt 程序 中 常用 的 显示 数据 表格 的 空间 ， 类 似 于 CH 
中 的 DataGrid。QTableWidget 是 QTableView 的 子 类 ， 它 使 用 标准 的 数据 
模型 ， 并 且 其 单元 格 数据 是 通过 QTableWidgetItem 对 象 来 实现 的 。 使 
用 QTableWidget 时 就 需要 QTableWidgetItem， 用 来 表示 表格 中 的 一 个 
单元 格 ， 整 个 表格 就 是 用 各 单元 格 构建 起 来 的 。 

QTableWidget 类 中 的 常用 方法 如 表 5-6 有 所 示 。 








表 5-6 


setSpan(int row, int column, int rowSpanCount, 


int columnSpanCount) 


setShowGrid() 


setColumn Width(int column, int width) 


setRowHeight(int row, int height) 


设置 QTableWidget 表格 控件 的 行 数 

设置 QTableWidget 表格 控件 的 列 数 

设置 QTableWidget 表格 控件 的 水 平 标签 

设置 QTableWidget 表格 控件 的 垂直 标签 

在 QTableWidget 表格 控件 的 每 个 选项 的 单元 空间 里 添加 控件 
获得 QTableWidget 表格 控件 的 表格 头 ， 以 便 执 行 隐藏 
获得 QTableWidget 表格 控件 的 行 数 

获得 QTableWidget 表格 控件 的 列 数 

设置 表格 是 否 可 编辑 。 设 置 编辑 规则 的 枚 举 值 
设置 表格 的 选择 行为 

设置 单元 格 内 文字 的 对 齐 方 式 

合并 单元 格 ， 要 改变 单元 格 的 第 row 行 第 column 列 ， 要 合并 
rowSpanCount 行 数 和 columnSpanCount 列 数 。 

e row: 要 改变 的 单元 格 行 数 

e column: 要 改变 的 单元 格 列 数 

e rowSpanCount: 需要 合并 的 行 数 

e columnSpanCount: 需要 合并 的 列 数 

在 默认 情况 下 ， 表 格 的 显示 是 有 网 格 线 的 。 

。 True: 显示 网 格 线 

。 False: 不 显示 网 格 线 

设置 单元 格 行 的 宽度 

设置 单元 格 列 的 高 度 





编辑 规则 的 枚 举 值 类 型 如 表 5-7 所 示 。 


表 5-7 


QAbstractItemView.NoEditTriggersONo 不 能 对 表格 内 容 进行 修改 
QAbstractItemView.CurrentChanged1Editing 任何 时 候 都 能 对 单元 格 进行 修 
QAbstractltem View.DoubleClicked2Editing 2 双击 单元 格 


QAbstractItemView.SelectedClicked4Editing 单 击 已 选中 的 内 容 
QAbstractItemView.EditKeyPressed8Editing 当 修改 键 被 按 下 时 修改 单元 格 


QAbstractItemView.AnyKeyPressed16Editing 16 按 任 意 键 修 改 单元 格 








表格 的 选择 行为 的 枚 举 值 类 型 如 表 5-8 所 示 。 


表 5-8 


E 





Qt.AlignLeft 将 单元 格 的 内 容 沿 单元 格 的 左边 缘 对 齐 


将 单元 格 的 内 容 沿 单元 格 的 右边 缘 对 齐 
将 文本 在 可 用 空间 中 对 齐 ， 默认 是 从 左 到 右 的 


单元 格 文本 的 垂直 对 齐 方式 如 表 5-10 所 示 。 





表 5-10 
在 可 用 空间 中 ， 居 中 显示 在 垂直 方向 上 





与 基线 对 章 

如 果 要 设置 水 平和 垂直 对 章 方式 ， 比 如 在 表格 空间 内 上 下 、 左 右 司 
中 对 齐 ， 那 么 只 要 使 用 QtAlignHCenter 和 Qt.AlignVCenter 即 可 。 

1. 基 本 用 法 

本 例文 件 名 为 PyQt5/Chapter05/gqt05_tblBasic.py， 主 要 介绍 基本 表格 





的 用 法 。 在 表格 控件 中 显示 的 数据 是 可 编辑 的 。 在 QTableWidget 表格 
中 具体 单元 格 就 是 QTableWidgetItem 类 。 其 完整 代码 如 下 : 





运行 脚本 ， 显 示 效 果 如 图 5-5 所 示 。 


列 。 











代码 分 析 : 
self.table=QTableWidget(4,3) 
上 面 这 行 代 码 构 造 了 一 个 QTableWidget 对 象 ， 并 且 设 置 表格 为 4 行 3 


tableWidget.setHorizontalHeaderLabels([' 姓 名 "性 别 ',' 体 重 (kg)']) 
上 面 这 行 代码 设置 了 表格 头 。 
newltem=QTableWidgetItem("3K =") 
上 面 这 行 代码 生成 了 一 个 QTableWidgetItem 对 象 ， 名 称 为 “ 张 三 ”。 
tableWidget.setItem(0,0,newItem) 
上 面 这 行 代码 将 刚才 生成 的 具体 单元 格 加 载 到 表格 的 第 0 行 第 0 列 





注意 
在 默认 情况 下 ， 表 格 里 的 字符 串 是 可 以 更 改 的 。 
C1) 设置 表格 头 


本 例文 件 名 为 PyQt5/Chapter05/qt05_tblHeader.py， 自 定义 表格 的 水 
平 表 头 标签 和 垂直 表 头 标签 。 

首先 ， 初 始 化 QTableWidget 的 实例 对 象 ， 生 成 一 个 4 行 3 列 的 表格 。 

tablewidget=QTableWidget() 

tableWidget.setRowCount(4) 

tableWidget.setColumnCount(3) 

然后 ， 设 置 表格 的 水 平 表 头 标签 和 垂直 表 头 标签 。 

tableWidget.setHorizontalHeaderLabels([‘WE 4 ','VE Sill’, hs Hi (kg)']) 

tableWidget.setVerticalHeaderLabels(['{7 1','472','473','47','47' J) 

注意 

生成 表格 ， 初 始 化 行 号 和 列 号 后 ， 再 设置 表格 的 表 头 标签 ， 人 否则 是 
没有 效果 的 。 

显示 效果 如 图 5-6 所 示 。 




















图 5-6 


(2) 设置 表格 头 为 伸缩 模式 。 


创建 一 个 4 行 3 列 的 表格 ， 表 格 头 信息 “姓名 性别“ 体重 Cg) ?水 
平 放置 ， 不 设置 表格 的 垂直 表 头 标签 ， 然 后 使 用 QTableWidget ”对象 的 
horizontalHeagerO 函 数 设 置 表 格 为 自 适 应 的 伸缩 模式 ， 即 可 根据 窗口 大 
小 来 改变 网 格 大 小 。 
tablewWidget=QTableWidget() 
tableWidget.setRowCount(4) 
tableWidget.setColumnCount(3) 
tableWidget.setHorizontalHeaderLabels([‘WE 4 ','VE Sill’, ks Hi (kg)']) 
tableWidget.horizontalHeader(). 
setSectionResizeMode(QHeaderView.Stretch) 
显示 效果 如 图 5-7 所 示 。 














(3) 将 表格 变 为 禁止 编辑 


在 默认 情况 下 ， 表 格 中 的 字符 串 是 可 以 更 改 的 ， 比 如 双击 一 个 单元 
格 ， 就 可 以 修改 原来 的 内 容 。 如 果 想 禁止 这 种 操作 ， 让 表格 对 用 户 是 只 
读 的 ， 则 可 以 编写 如 下 代码 。 
tableWidget.setEditTriggers(QAbstractItemView.NoEditTriggers) 
(4) 设置 表格 整 行 选中 
表格 默认 选中 的 是 单个 单元 格 ， 通 过 下 面 的 代码 可 以 设置 成 整 行 选 
HH 








tableWidget.setSelectionBehavior( QAbstractItemView.SelectRows) 
显示 效果 如 图 5-8 所 示 。 
(5) 将 行 和 列 的 宽度 、 高 度 设 置 为 与 所 显示 内 容 的 宽度 、 高 度 相 
匹配 





QTableWidget.resizeColumnsToContents() 
QTableWidget.resizeRowsToContents() 
显示 效果 如 图 5-9 所 示 。 

















姓名 性 别 体重 (kg) 
1EB 160 








(6) 表格 头 的 显示 与 隐藏 
对 于 水 平方 癌 的 表 头 ， 采 用 以 下 代码 进行 隐藏 或 显示 设置 。 
tableWidget.verticalHeader().setVisible(False) 
对 于 和 对 直方 癌 的 表 头 ， 采 用 以 下 代码 进行 隐藏 或 显示 设置 。 
tableWidget.horizontalHeader().setVisible(False) 
将 表格 头 隐 藏 起 来 的 效果 如 图 5-10 所 示 。 























图 5-10 


(7) 在 单元 格 中 放置 控件 
QTableWidget 不 仅 多 许 往 单元 格 中 放置 文字 ， 还 允许 放置 控件 ， 通 
过 TableWidget.setItem() 来 添加 PyQt 的 基本 控件 。 
本 例文 件 名 为 PyQt5/Chapter05/qt05_tblCmb.py， 演 示 把 一 个 下 拉 列 
表 框 和 一 个 按钮 加 入 单元 格 中 ， 并 设置 控件 与 单元 格 的 边 距 ， 如 为 
3px (RA) 。 其 核心 代码 如 下 : 
comBox=QComboBox() 
comBox.addItem(" 35") 
comBox.addItem("%") 
comBox.setStyleSheet("QComboBox{margin:3px};") 
tableWidget.setCellWidget(0, 1,comBox) 
searchBtn=QPushButton("(Z gt") 


searchBtn.setDown( True ) 


searchBtn.setStyleSheet("QPushButton {margin:3px};") 
tableWidget.setCellWidget(0,2,searchBtn) 
显示 效果 如 图 5-11 所 示 。 


体重 (kg) 
修改 




















图 5-11 


(8) 在 表格 中 快速 定位 到 指定 行 

当 tableWidget 表 格 的 行 数 很 多 时 ， 可 以 通过 输入 行 号 进行 直接 定位 
并 显示 ， 比 如 输入 10， 就 直接 显示 第 10 行 。 

# 遍 历 表格 查找 对 应 的 具体 单元 格 

item=self.tableWidget.findItems(text,QtCore.Qt.MatchExactly ) 

# 获 取 其 行 号 

row=item[0].row() 

# 模 拟 鼠 标 滚 轮 快速 定位 到 指定 行 

self.tableWidget.verticalScrollBar().setSliderPosition(row) 

本 例文 件 名 为 PyQt5/Chapter05/qt05_tbSelItem.py， 演 示 在 








tableWidget 表 格 中 快速 定位 到 指定 行 。 其 完整 代码 如 下 : 


import sys 

from PyQt5.QtWidgets import * 

from PyQt5 import QtCore 

from PyOt5.QtGui import QColor , QBrush 


class Table (QWidget) : 
def _ imit (qseli: 


Super Gi. dare, 4) 
self.initUI () 


def initUI (self): 
self.setWindowTitle("QTableWidget 例子 ") 
self.resize (600,800); 
conLayout = QHBoxLayout () 
tableWidget = QTableWidget () 
tableWidget.setRowCount (30) 
tableWidget.setColumnCount (4) 
conLayout.addWidget (tableWidget ) 


for i in range(30): 
for j in range(4): 
itemContent = '(%d,%d)'%S (i,j) 
tableWidget.setItem(i,j, QTableWidgetItem( itemContent ) ) 
self.setLayout (conLayout) 


# 遍 历 表格 查找 对 应 项 

text = "(107 IYU 

items = tableWidget.findItems (text, QtCore.Qt.MatchExactly) 
item = items[0] 

# 选中 单元 格 

#item.setSelected( True) 

# 设置 单元 格 的 背景 颜色 为 红色 

item.setForeground (QBrush(QColor(255, 0, 0))) 


row = item. row() 
# 通 过 和 鼠标 滚轮 定位 ， 快 速 定 位 到 第 11 行 


tableWidget.verticalScrollBar().setSliderPosition (row) 


if _ name == * malin ': 
app = QApplication(sys.argv) 
example = Table() 
example.show() 


Sys.exit (app.exec_()) 


运行 脚本 ， 显 示 效 果 如 图 5-12 所 示 。 


2. 设 置 单 元 格 

(1) 设置 单元 格 文本 颜色 

将 表格 第 一 行 中 三 个 单元 格 的 文本 颜色 设置 为 红色 。 本 例文 件 名 为 
PyQt5/Chapter05/qt05_tblItemColor.py， 其 核心 代码 如 下 : 





11 (10,0) 
12 (11,0) 
13 (12,0) 
14 (13,0) 
15 (14,0) 
16 (15,0) 
17 (16,0) 
18 (17,0) 
19 (18,0) 
20 (19,0) 
21 (20,0) 
22 (21,0) 
23 (22,0) 
24 (23,0) 
25 (24,0) 
26 (25,0) 
27 (26,0) 
28 (27,0) 


29 (28,0) 





30 (29,0) 
be 








图 5-12 


newItem=QTableWidgetItem(" 张 三 " 
newltem.setForeground(QBrush(QColor(255,0,0))) 
tableWidget.setItem(0,0,newlItem) 
newltem=QTableWidgetltem(" 55") 
newltem.setForeground(QBrush(QColor(255,0,0))) 
tableWidget.setItem(0,1,newItem) 
newltem=QTableWidgetItem("160") 
newltem.setForeground(QBrush(QColor(255,0,0))) 
tableWidget.setItem(0,2,newlItem) 

显示 效果 如 图 5-13 所 示 。 








图 5-13 


(2) 将 字体 加 粗 
本 例文 件 名 为 PyQt5/Chapter05/qt05_tblItemFont.py， 其 核心 代码 如 
ips 
newltem=QTableWidgetItem("3K =" 
newltem.setFont( QFont( "Times",12,QFont.Black ) ) 
tableWidget.setItem(0,0,newltem) 


newltem=QTableWidgetItem(" 55") 
newltem.setFont( QFont( "Times",12,QFont.Black ) ) 
tableWidget.setItem(0,1,newlItem) 
newltem=QTableWidgetItem("160") 
newltem.setFont( QFont( "Times",12,QFont.Black ) ) 
tableWidget.setItem(0,2,newlItem) 

显示 效果 如 图 5-14 上 所 示 。 


体重 (kg) 
160 














图 5-14 


(3) 设置 单元 格 的 排序 方式 
查看 Qt 的 开发 文档 Chttps://doc.qt.io/qt-5/qt.html#details) ， 可 以 看 
到 使 用 Qt.DescendingOrder 表 示 在 单元 格 内 降序 排列 ， 使 用 
Qt.AscendingOrder 表 示 在 单元 格 内 升序 排列 。 但 是 需要 使 用 以 下 语句 从 
PyQt5.QtCore 模 块 导 入 Qt 类 。 
from PyQt5.QtCore import Qt 
本 例文 件 名 为 PyQt5/Chapter05/qt05_tblItemOrder.py， 演 示 在 表格 中 
按照 体重 进行 降序 排列 显示 ， 其 核心 代码 如 下 : 
# Qt.DescendingOrder 降序 


# Qt.AscendingOrder 升序 
tableWidget.sortItems(2,QtCore.Qt.DescendingOrder ) 
显示 效果 如 图 5-15 所 示 。 
(4) 设置 单元 格 文本 的 对 齐 方式 
使 用 QTableWidgetItem.setTextAlignment(inb) 函 数 设置 单元 格 文本 的 
对 齐 方式 ， 该 函数 的 参数 为 对 齐 方式 。 
查看 Qt 的 开发 文档 Chttps://doc.qt.io/qt-5/qt.html#details) ， 可 以 看 
到 水 平和 入 直方 同上 的 对 齐 方式 。Qt 的 文本 对 章 方式 同样 也 可 以 应 用 在 
PyQt5 中 。 
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本 例文 件 名 为 PyQt5/Chapter05/qt05_tbltemAlign.py， 演 示 第 一 行 第 
一 列 的 单元 格 内 容 右 对 齐 并 与 底部 对 齐 。 其 核心 代码 如 下 : 
tableWidget.setHorizontalHeaderLabels([' 姓 名 "性别 ',' 体 重 (kg)'"]) 
newltem=QTableWidgetItem("3K =") 
newltem.setTextAlignment( Qt.AlignRight| Qt.AlignBottom ) 
tableWidget.setItem(0,0,newltem) 


显示 效果 如 图 5-16 所 示 。 











图 5-16 


(5) 合并 单元 格 效果 的 实现 
比如 ， 将 表格 中 第 一 行 第 一 列 的 单元 格 ， 更 改 为 占据 3 行 1 列 。 核 心 
代码 如 下 : 
tableWidget.setSpan(0,0,3,1) 
本 例文 件 名 为 PyQt5/Chapter05/qt05_tbltemSpan.py， 其 核心 代码 如 
F: 
tablewidget=QTableWidget() 
tableWidget.setRowCount(4) 
tableWidget.setColumnCount(3) 
tableWidget.setHorizontalHeaderLabels([' 姓 名 "性别 ,体重 (kg)]) 
tableWidget.setSpan(0,0,3,1) 
newltem=QTableWidgetItem("3K =" 
tableWidget.setItem(0,0,newItem) 
newltem=QTableWidgetItem(" 55") 


tableWidget.setItem(0,1,newlItem) 

newltem=QTableWidgetItem("160") 

tableWidget.setItem(0,2,newItem) 
MEAN BOR 5-17 AAS 
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(6) 设置 单元 格 的 大 小 
本 例文 件 名 为 PyQt5/Chapter05/ qt05_tblRow.py， 演 示 将 第 一 列 的 单 
元 格 宽度 设置 为 150， 将 第 一 行 的 单元 格 高 度 设 置 为 120。 
# 将 第 一 列 的 单元 格 宽度 设置 为 150 
tableWidget.setColumnWidth(0,150) 
# 将 第 一 行 的 单元 格 高 度 设置 为 120 
tableWidget.setRowHeight(0, 120) 
显示 效果 如 图 5-18 所 示 。 














图 5-18 


(7) 在 表格 中 不 显示 分 割 线 
QTableWidget 类 的 setShowGrid() 函 数 是 从 QTableView 类 继承 的 ， 
用 来 设置 是 否 显示 表格 的 分 割 线 ， 默 认 显 示 分 割 线 。 使 用 以 下 代码 ， 则 
不 显示 分 割 线 。 
tableWidget.setShowGrid(False) 
显示 效果 如 图 5-19 所 示 。 





图 5-19 








在 很 多 情况 下 ， 应 用 程序 中 的 表格 只 需要 显示 水 平 表 头 ， 而 不 需要 
显示 和 对 直 表 头 ， 这 时 可 以 使 用 以 下 代码 。 
tableWidget.verticalHeader().setVisible(False) 
显示 效果 如 图 5-20 所 示 。 





图 5-20 


(8) 为 单元 格 添加 图 片 
还 可 以 在 单元 格 内 添 加 图 片 ， 并 显示 图 片 的 描述 信息 。 本 例文 件 名 
为 PyQt5/Chapter05/gqt05_tblItemIcon01.py， 其 核心 代码 如 下 : 
newltem=QTableWidgetItem(QIcon("./images/bao1.png"),"4 ©") 
self.tableWidget.setItem(0,3,newltem ) 
显示 效果 如 图 5-21 所 示 。 








图 5-21 


(9) 改变 单元 格 中 显示 的 图 片 大 小 
使 用 QTableWidget 默 认 处 理 QTableWidgetItem 对 象 ， 在 每 个 单元 格 
中 放置 图 片 。 本 例文 件 名 为 PyQt5/Chapter05/gqt05_tblItemIcon02.py， 其 
核心 代码 如 下 : 








显示 效果 如 图 5-22 所 示 。 
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(10) 获得 单元 格 的 内 容 
通过 实现 itemClicked (QTableWidgetItem *) 信号 的 槽 函数 ， 可 以 获 
得 所 点 击 的 单元 格 的 引用 ， 进 而 获得 其 中 的 内 容 。 以 下 代码 将 
itemClicked 信 号 与 getltem() 函 数 进行 绑 定 
tableWidget.itemClicked.connect( self.handleItemClick ) 
def getItem(self,item): 


print('you selected= > '+ item.text()) 


3.50 FF A BESS 
本 例文 件 名 为 PyQt5/Chapter05/qt05_tblMenu.py， 其 完整 代码 如 下 : 


import sys 

from PyOQt5.QtWidgets import (QMenu, QPushButton, QWidget, OTableWidget, 
QHBoxLayout, QApplication, QDesktopWidget, QOTableWidgetItem, QHeaderView) 

from PyQt5.QtCore import pyqtSignal, QObject, Qt, pyqtSlot 


class Table( QWidget ): 


def init (self): 
super). ipie it) 
self.initulI () 


def initUI (self): 
self.setWindowTitle ("OQTableWidget demo") 
self.resize (500,300); 
conLayout = QHBoxLayout () 
self.tableWidget= QTableWidget () 
self.tableWidget.setRowCount (5) 
self.tableWidget.setColumnCount (3) 
conLayout.addWidget (self.tableWidget ) 





self.tableWidget.setHorizontalHeaderLabels (['#4', '' 性 别 ', ' 体 重 ' ]) 
self.tableWidget.horizontalHeader(). 


setSectionResizeMode (QHeaderView. Stretch) 


newltem = QTableWidgetItem("sk=") 
self.tableWidget.setItem(0, 0, newlItem) 


newltem = QTableWidgetItem("#") 
self.tableWidget.setItem(0, 1, newItem) 


newltem = QTableWidgetItem("160") 
self.tableWidget.setItem(0, 2, newlItem) 
+ 表格 中 第 二 行 记录 

newItem = QTableWidgetItem("#W") 
self.tableWidget.setItem(1, 0, newltem) 


newltem = QTableWidgetItem("*«") 
self.tableWidget.setItem(1, 1, newItem) 


newltem = QTableWidgetItem("170") 


self.tableWidget.setItem(1, 2, newlItem) 
# 允许 右键 产生 菜单 


self.tableWidget.setContextMenuPolicy (Qt.CustomContextMenu) 
# HARK Lp ce 3) BHM generateMenu 
self.tableWidget.customContextMenuRequested. 

connect (self.generateMenu) 


self.setLayout (conLayout) 


def generateMenu(self,pos): 
row num = -1 
for iin self.tableWidget.selectionModel () .selection().indexes(): 


row num = i.row() 


# 表格 中 只 有 两 条 有 效 数据 ， 所 以 只 在 前 两 行 支持 右键 弹出 菜单 
if row num < 2 
menu = QMenu() 
iteml = menu.addAction (un 选项 一 ") 
item2 = menu.addAction (un 选项 二 ") 
item3 = menu.addAction (u" 选 项 三 "” ) 
action = menu.exec (self.tableWidget.mapToGlobal (pos) ) 
if action == iteml: 
print ( ! 您 选 了 选项 一 ， 当 前 行文 字 内 容 是 : ' ,self.tableWidget. 
item(row_num,0).text(),self.tableWidget.item(row num,1).text() ,self.tab 
leWidget.item(row_num, 2) .text()) 


elif action == item2: 
print ( ' 您 选 了 选项 二 ， 当 前 行文 字 内 容 是 : ' self.tableWidget. 
item(row_num, 0) .text(),self.tableWidget.item(row_num,1).text() ,self.tab 


leWidget.item(row_num,2).text() ) 


elif action == item3: 
print( ' 您 选 了 选项 三 ， 当 前 行文 字 内 容 是 : ', self.tableWidget. 
item(row num,0).text(),self.tableWidget.item(row num,1).text() ,self.tab 
leWidget.item(row_num,2).text() ) 
else: 


return 


if name == ' main ': 
app = QApplication(sys.argv) 
example = Table() 
example.show () 
sys.exit(app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 5-23 所 示 。 
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图 5-23 
选中 某 个 香 元 格 后 ， 单 击 鼠 标 右 键 ， 从 弹出 的 快捷 菜单 中 选择 “ 选 


项 一 ”， 后 人 台 的 输出 结果 为 : 
您 选 了 选项 一 ， 当 前 行文 字 内 容 是 : 张 三 男 160 








5.1.5 OTreeView 


QTreeWidget 类 实现 了 树 形 结构 ， 效 果 如 图 5-24 所 示 。 


Key Value 
4 @ root 
@ child! ios 
4 i child2 


{ò child3 android 





图 5-24 
QTreeWidget 类 的 继承 结构 如 下 : 


QWidget 
| 
t- QF rame 
| 
+- QAbstractScrollArea 
| 
+- QAbstractItemView 


| 
+- QAbstractScrollArea 


| 
+- QAbstractItemView 
| 
+- QTreeView 
| 
+- QTreeWidget 





QTreeWidget 类 中 的 常用 方法 如 表 5-11 所 示 。 


表 5-11 
ARO’ Hi R 





setColumnWidth(int column, int width) 将 指定 列 的 宽度 设置 为 给 定 的 值 


Column， 指 定 的 列 


insertTopLevelltems() 在 视图 的 顶层 索引 中 插入 项 目 列表 
expandAll() 展开 所 有 的 树 形 节点 

invisibleRootItem() 返回 树 形 控件 中 不 可 见 的 根 选项 (Root Item) 
selectedItems() 返回 所 有 选 定 的 非 隐藏 项 目的 列表 


QTreeWidgetItem 类 中 的 常用 方法 如 表 5-12 所 示 。 
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addChild() 


setText() 设置 显 





Text() 


setCheckState(column, _ state) 设置 指定 列 的 选中 状态 : 


Qt.Checked， 节 点 选中 
Qt.Unchecked， 节 点 未 选中 


setIcon(column, icon) 在 指定 的 列 中 显示 图 标 

1. 树 形 结构 的 实现 

树 形 结构 是 通过 QTreeWidget 和 QTreeWidgetItem 类 实现 的 ， 其 中 
QTreeWidgetItem 类 实现 了 节点 的 深 加 。 

本 例文 件 名 为 PyQt5/Chapter05/qt05_treewidget01.py， 演 示 树 形 结构 
的 实现 。 其 核心 代码 如 下 : 

self.tree=QTreeWidget() 

# 设置 列 数 

self.tree.setColumnCount(2) 

# 设置 树 形 控件 头 部 的 标题 

self.tree.setHeaderLabels(['Key’','Value']) 

# WEAR A 

root=QTreeWidgetltem(self.tree) 








root.setText(0,'root’) 
root.setIcon(0,QIcon("./images/root.png")) 

# 设置 树 形 控件 的 列 的 宽度 
self.tree.setColumnWidth(0, 160) 

# 设置 子 节 点 1 
child1=QTreeWidgetItem(root) 
child1.setText(0,'child1') 
child1.setText(1,'ios’) 
child1.setIcon(0,QIcon("./images/IOS.png")) 
# 设置 子 节 点 2 
child2=QTreeWidgetItem(root) 
child2.setText(0,'child2') 

child2.setText(1,") 
child2.setIcon(0,QIcon("./images/android.png")) 
# 设置 子 节 点 3 
child3=QTreeWidgetItem(child2) 
child3.setText(0,'child3') 
child3.setText(1,'android’') 
child3.setIcon(0,QIcon("./images/music.png")) 
self.tree.addTopLevelltem(root) 

# 点 全 部 展开 

self.tree.expandAll() 

除了 使 用 上 面 的 方法 ， 还 可 以 通过 


QTreeWidget.insertTopLevelItems() 来 实现 树 形 结 构 。 其 核心 代码 如 下 : 


self.tree=QTreeWidget() 
# 设置 列 数 


self.tree.setColumnCount(2) 


# 设置 树 形 控件 头 部 的 标题 
self.tree.setHeaderLabels(['Key’,'Value']) 
EREI TA 
root=QTreeWidgetItem() 
root.setText(0,'root') 
rootList=[] 
rootList.append(root) 
# 设置 树 形 控件 的 子 节点 1 
child1=QTreeWidgetItem() 
child1.setText(0,'child1') 
child1.setText(1,'ios’) 
root.addChild(child1) 
self.tree.insertTopLevelltems(0,rootList) 
(1) 设置 市 点 状态 
可 以 使 用 QTreeWidgetItem 的 setCheckState(0) 函 数 设 置 节点 是 否 为 选 
中 状态 。 其 核心 代码 如 下 : 
child1=QTreeWidgetItem(root) 
child1.setText(0,'child1') 
child1.setText(1,'ios’) 
child1.setIcon(0,QIcon("./images/IOS.png")) 
child1.setCheckState(0,Qt.Checked) 
显示 效果 如 图 5-25 所 示 。 
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图 5-25 


(2) 设置 节点 的 背景 颜色 
可 以 使 用 QBrush 类 来 设置 节点 的 背景 颜色 ， 例 如 设置 根 节 点 的 背景 
颜色 ， 其 核心 代码 如 下 : 
root=QTreeWidgetltem(self.tree) 
root.setText(0,'root’) 
root.setIcon(0,QIcon("./images/root.png")) 
brush_red=QBrush(Qt.red) 
root.setBackground(0,brush_red) 
brush_green=QBrush(Qt.green) 
root.setBackground(1,brush_green) 
2. 给 节操 添加 啊 应 事件 
本 例文 件 名 为 PyQt5/Chapter05/qt05_treewidget02.py， 演 示 当 单 击 树 
形 控件 时 ， 触 发 树 形 控件 节点 的 啊 应 事件 。 其 完整 代码 如 下 。 


self.setCentralWidget (self.tree) 


def onTreeClicked(self, qmodelindex) : 
item = self.tree.currentItem() 


print ("key=%s ,value=%s" % (item.text(0), item.text(1))) 


Hse eye) SS a 
app = QApplication(sys.argv) 
tree = TreeWidgetDemo () 
tree. show () 


sys.exit (app.exec_()) 


运行 脚本 ， 显 示 效 果 如 图 5-26 所 示 。 
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3. 系 统 定 制 模式 

在 上 面 的 例子 中 ，QTreeWidgetItem 类 的 节点 是 一 个 个 添加 的 ， 这 
样 做 有 时 很 不 方便 ， 特 别 是 当 窗 口中 产生 比较 复杂 的 树 形 结构 时 ， 一 般 
都 是 通过 QTreeView 类 来 实现 的 ， 而 不 是 QTreeWidget 类 。QTreeView 类 
与 “QTreeWidget 类 最 大 的 区 别 就 是 ，QTreeView 类 可 以 使 用 操作 系统 提 


供 的 定制 模式 ， 比 如 文件 系统 盘 的 树 列表 。 
本 例文 件 名 为 PyQt5/Chapter05/qt05_treeview.py， 演 示 在 树 形 控件 
中 使 用 系统 的 定制 模式 。 其 完整 代码 如 下 : 
import sys 
from PyQt5.QtWidgets import * 
from PyQt5.QtGui import * 
if name ==' main_': 
app=QApplication(sys.argv) 
# Window 系 统 提 供 的 模式 
model=QDirModel() 
# 创建 一 个 QTreeView 控 件 
tree=QTreeView() 
# 为 控件 添加 模式 
tree.setModel(model) 
tree.setWindowTitle( "QTreeView 例子 " ) 
tree.resize(640,480) 
tree.show() 
sys.exit(app.exec_()) 
运行 脚本 ， 显 示 效 果 如 图 5-27 所 示 。 


Type Date Modified 
Drive 2017/5/10 12:49 
= AVScanner.ini 30 byte(s) ini File 2017/5/10 12:46 
Intel File Folder 2015/2/8 17:17 
PerfLogs File Folder 2013/8/22 23:22 
Program Files File Folder 2017/3/25 14:23 
Program Files (x86) File Folder 2017/5/10 12:49 
_ Users File Folder 2017/3/21 13:53 
Windows File Folder 2017/5/16 1:01 
mfg File Folder 2015/2/8 16:33 


tmp File Folder 2017/4/11 9:06 
Drive 2017/5/17 21:50 


> [EZ E: Drive 2017/5/17 20:13 





图 5-27 


5.2 Age: RE Jiz 
有 时 候 我 们 可 能 会 面临 这 样 一 种 情况 :所 开发 的 程序 包含 了 太 多 的 
控件 ， 导 致 一 个 窗口 装载 不 下 或 者 装载 的 控件 太 多 而 不 美观 。 本 节 就 来 
解决 这 个 问题 ， 即 如 何在 现 有 的 窗口 空间 中 装载 更 多 的 控件 


5.2.1 QTabWidget 


QTIabWidget 控 件 提供 了 一 个 选项 卡 和 一 个 页 面 区 域 ， 默 认 显 示 第 
一 个 选项 卡 的 页 面 。 通 过 单 击 各 选项 卡 可 以 查看 对 应 的 页 面 。 如 果 在 一 
个 窗口 中 显示 的 输入 字段 很 多 ， 则 可 以 对 这 些 字段 进行 拆 分 ， 分 别 放置 
在 不 同 页 面 的 选项 卡 中 。 

QTabWidget 类 中 的 常用 方法 如 表 5-13 所 示 。 














表 5-13 


方 ” 法 fi g 
addTab() 将 一 个 控件 添加 到 Tab 控件 的 选项 卡 中 


将 一 个 Tab 控件 的 选项 卡 插入 到 指定 的 位 轩 
根据 指定 的 索引 删除 Tab 控件 

设置 当前 可 见 的 选项 卡 所 在 的 索引 

设置 当前 可 见 的 页 面 





设置 选项 卡 栏 的 小 控件 
setTabPosition() 设置 选项 卡 的 位 置 : 
© QTabWidget.North， 显 示 在 页 面 的 上 方 
© QTabWidget.South， 显 示 在 页 面 的 下 方 
© QTabWidget.West， 显 示 在 页 面 的 左 侧 
© QTabWidget.East， 显 示 在 页 面 的 右 侧 





QTabWidget 类 中 的 常用 信号 如 表 5-14 所 示 。 


表 5-14 
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案例 5-4 QTabWidget 的 使 用 


本 例文 件 名 为 PyQt5/Chapter05/gt05_QTabWidget.py， 演 示 在 PyQt 5 
的 窗口 中 使 用 QTabWidget 控 件 。 其 完整 代码 如 下 : 


import sys 

from PyOt5.QtCore import * 
from PyOQt5.QtGui import * 
from PyQt5.QtWidgets import * 


class TabDemo (QTabWidget) : 
def init (self, parent=None): 

super (TabDemo, self). init (parent) 
self.tabl = QWidget() 

self.tab2 = QWidget() 

self.tab3 = QWidget() 
self.addTab(self.tabl,"Tab 1") 
self.addTab(self.tab2,"Tab 2") 
self.addTab(self.tab3,"Tab 3") 


self.tabl1UI () 
self.tab2UI () 
self.tab3UI () 
self.setWindowTitle("Tab 例子 ") 


def tablUI (self): 
layout = QFormLayout () 
layout .addRow ("姓名 ", QLineEdit () ) 
layout .addRow ("地 址 ", QLineEdit () ) 
self.setTabText (0,"KAAK") 
self.tabl.setLayout (layout) 


def tab2UI (self): 
layout = QFormLayout () 
sex = QHBoxLayout () 
sex.addWidget (QRadioButton("F") ) 
sex.addWidget (QRadioButton ("*") ) 
layout .addRow (QLabel (" 性 别 ") , sex) 
layout .addRow("#H",QLineEdit () ) 
self.setTabText (1, "个 人 详细 信息 ") 
self.tab2.setLayout (layout) 


def tab3UI (self): 
layout = QHBoxLayout () 
layout .addWidget (QLabel ("科目 ")) 
layout .addWidget (QCheckBox ("438") ) 
layout .addWidget (QCheckBox ("高 数 ")) 
self.setTabText (2, "教育 程度 ") 
self.tab3.setLayout (layout) 


Lt name == I main <; 
app = QApplication(sys.argv) 
demo = TabDemo () 
demo. show () 


sys.exit (app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 5-28、 图 5-29 和 图 5-30 所 示 。 
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图 5-30 
代码 分 析 : 
在 这 个 例子 中 ， 一 个 表单 的 内 容 分 为 三 组 ， 每 一 组 小 控件 都 显示 在 
不 同 的 选项 卡 中 。 顶 层 窗口 是 一 个 QTablWidget 控 件 ， 将 三 个 选项 卡 添 
MEE, 





self.tab1=QWidget() 
self.tab2=QWidget() 
self.tab3=QWidget() 
self.addTab(self.tab1,"Tab 1") 
self.addTab(self.tab2,"Tab 2") 
self.addTab(self.tab3,"Tab 3") 

使 用 表单 布局 管理 器 ， 每 个 选项 卡 显示 子 表 单 中 的 内 容 。 
self.setTabText(0," Fk % 77 zk") 
self.setTabText(1," 个 人 详细 信息 ") 
self.setTabText(2," 教 育 程度 ") 


5.2.2 QStackedWidget 


QStackedWidget 是 一 个 堆栈 窗口 控件 ， 可 以 填充 一 些小 控件 ， 但 同 
一 时 间 只 有 一 个 小 控件 可 以 显示 。QStackedWidget 使 用 QStackedLayout 
布局 。QStackedWidget 控 件 与 QTabWidget 类 似 ， 可 以 有 效 地 显示 窗口 中 
的 控件 。 
案例 5-5 QStackedWidget 的 使 用 
本 例文 件 名 为 PyQt5/Chapter05/qt05_QStackedWidget.py， 演 示 在 
PyQt 5 的 窗口 中 使 用 QStackedWidget 控 件 。 其 完整 代码 如 下 : 


self.leftlist.insertItem (0, "RAZA! ) 
self.leftlist.insertItem (1, "个 人 信息 ' ) 
self.leftlist.insertItem (2，' 教 育 程度 ' ) 
self.stackl = QWidget () 

self.stack2 = QWidget() 

self.stack3 QWidget () 

self.stacklUI () 

self.stack2UI () 

self.stack3UI () 

self.Stack = QStackedWidget (self) 
self.Stack.addWidget (self.stack1) 
self.Stack.addWidget (self.stack2) 
self.Stack.addWidget (self.stack3) 

hbox QHBoxLayout (self) 

hbox.addWidget (self.leftlist) 
hbox.addWidget (self.Stack) 
self.setLayout (hbox) 


self.leftlist.currentRowChanged.connect (self.display) 


def stacklUI (self): 
layout=OFormLayout () 
layout.addRow ("#L4", QLineEFdit ()) 
layout .addRow ("地 址 ",QLineEdit()) 
self.stackl.setLayout (layout) 


def stack2UI (self): 
layout = QFormLayout () 
sex = QHBoxLayout () 
sex.addWidget (QRadioButton (" 男 ")) 
sex.addWidget (QRadioButton (" 女 ")) 
layout .addRow (QLabel ("性 别 ")， sex) 
layout.addRow ("生日 ", QLineEdit()) 
self.stack2.setLayout (layout) 


def stack3UI (self): 
layout=QHBoxLayout () 
layout .addWidget (QLabel ("科目 ")) 
layout .addWidget (QCheckBox ("432") ) 
layout .addWidget (QCheckBox ("4k") ) 
self.stack3.setLayout (layout) 


def display(self,i): 
self.Stack.setCurrentIndex (i) 


了 
app = QApplication(sys.argv) 
demo = StackedExample () 
demo. show () 
sysi.exit (app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 5-31、 图 5-32 和 图 5-33 所 示 。 
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图 5-33 


代码 分 析 : 

在 这 个 例子 中 ， 在 QStackedWidget 对 象 中 填充 了 三 个 子 控件 。 
self.Stack=QStackedWidget (self) 
self.stack1=QWidget() 
self.stack2=QWidget() 
self.stack3=QWidget() 
self.Stack.addWidget(self.stack1) 
self.Stack.addWidget(self.stack2) 
self.Stack.addWidget(self.stack3) 

ES THe ECKA, LR Ee CR 
QStackedWidget 控件 不 能 在 页 面 之 间 切 换 ， 它 与 当前 选中 的 
QListWidget 控 件 中 的 选项 进行 连接 。 

self.leftlist=QListWidget () 

self.leftlist.insertItem (0,' 联 系 方式 ' ) 
self.leftlist.insertItem (1,' 个 人 信息 ') 
self.leftlist.insertItem (2, 教 育 程 度 ' ) 
self.leftlist.currentRowChanged.connect(self.display) 

将 QListWidget 的 currentRowChanged 信 号 与 display0) 模 函数 相关 联 ， 
从 而 改变 堆 琶 控件 的 视图 。 

def display(self,i): 
self.Stack.setCurrentIndex(i) 





5.2.3 QDock Widget 


QDockWidget 是 一 个 可 以 停靠 在 QMainWindow 内 的 窗口 控件 ， 它 
可 以 保持 在 浮动 状态 或 者 在 指定 位 置 作为 子 窗口 附加 到 主 窗口 中 。 














QMainWindow 类 的 主 窗口 对 象 保留 有 一 个 用 于 停靠 窗口 的 区 域 ， 这 个 
区 域 在 控件 的 中 央 周 围 ， 如 图 5-34 所 示 。 


Toolbars 


Dock windows 


Central widget 





图 5-34 





QDockWidget 控 件 在 主 窗口 内 可 以 移动 到 新 的 区 域 。QDockWidget 
类 中 的 常用 方法 如 表 5-15 所 示 。 





表 5-15 


setAllowedAreas() 设置 窗口 可 以 停靠 的 区 域 : 
eLeftDockWidgetArea， 左 边 停靠 区 域 


è RightDockWidgetArea， 右 边 停靠 区 域 
© TopDockWidgetArea， 顶 部 停靠 区 域 
© BottomDockWidgetArea， 底 部 停靠 区 域 
© NoDockWidgetArea， 不 显示 Widget 
setFeatures() 设置 停靠 窗口 的 功能 属性 : 
© DockWidgetClosable， 可 关闭 
è DockWidgetMovable， 可 移动 
© DockWidgetFloatable， 可 漂浮 
è DockWidgetVerticalTitleBar， 在 左边 显示 重 直 的 标签 栏 
。 AllDockWidgetFeatures， 有 具有 前 三 种 属性 的 所 有 功能 
© NoDockWidgetFeatures， 无 法 关闭 ， 不 能 移动 ， 不 能 漂浮 


案例 5-6 QDockWidget 的 使 用 


本 例文 件 名 为 PyQt5/Chapter05/q9t05_QDockWidget.py， 演 示 在 PyQt 
5 的 窗口 中 使 用 QDockWidget 控 件 。 其 完整 代码 如 下 : 





import sys 

from PyQt5.QtCore import * 
from PyOt5.QtGui import * 
from PyQt5.QtWidgets import * 


class DockDemo (QMainWindow) : 
det anit (self; parent=None)|: 

super (DockDemo, self). init (parent) 
layout = QHBoxLayout () 
bar=self.menuBar () 
file=bar.addMenu ("File") 
file.addAction ("New") 
file.addAction ("save") 
file.addAction ("quit") 
self.items = QDockWidget ("Dockable", self) 
self.listWidget = QListWidget () 
self.listWidget.addItem("item1") 
self.listWidget.addItem("item2") 
self.listWidget.addItem("item3") 
self.items.setWidget (self.listWidget) 
self.items.setFloating (False) 
self.setCentralWidget (QTextEdit ()) 
self.addDockWidget (Qt.RightDockWidgetArea, self.items) 
self.setLayout (layout) 
self.setWindowTitle ("Dock 例子 ") 


if name == ' main_': 
app = QApplication(sys.argv) 
demo = DockDemo () 
demo. show () 


Sys exit (app-exec (J) 


运行 脚本 ， 显 示 效 果 如 图 5-35 所 示 。 
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图 5-35 
代码 分 析 : 


在 这 个 例子 中 ， 顶 层 窗口 是 一 个 QMainWindow 对 象 ，QTextEdit 对 
象 是 它 的 中 央 小 控件 。 

self.setCentralWidget(QTextEdit()) 

首先 ， 创 建 可 停靠 的 窗口 items。 
self.items=QDockWidget("Dockable",self) 

然后 ， 在 停靠 窗口 items 内 添加 QListWidget 对 象 。 
self.listWidget=QListWidget() 
self.listWidget.addItem("item1") 
self.listWidget.addItem("item2") 
self.listWidget.addItem("item3") 
self.items.setWidget(self.listWidget) 

最 后 ， 将 停靠 窗口 放置 在 中 央 小 控件 的 右 侧 。 
self.addDockWidget(Qt.RightDockWidgetArea,self.items) 








5.2.4 多 文档 界面 





一 个 典型 的 GUI 应 用 程序 可 能 有 多 个 窗口 ， 选 项 卡 控 件 和 堆栈 窗口 
控件 允许 一 次 使 用 其 中 的 一 个 窗口 。 然 而 ， 很 多 时 候 这 种 方法 不 是 很 有 
用 ， 因 为 其 他 窗口 的 视图 是 隐藏 的 。 

一 种 同时 显示 多 个 窗口 的 方法 是 ， 创 建 多 个 独立 的 窗口 ， 这 些 独 立 
的 窗口 被 称 为 SDI (Single Document Interface， 单 文档 界面 ) ， 每 个 窗 
口 都 可 以 有 自己 的 沫 单 系统 、 工 具 栏 等 。 这 需要 占用 较 多 的 内 存 资源 。 

MDI (Multiple Document Interface， 多 文档 界面 ) 应 用 程序 占用 较 
少 的 内 存 资源 ， 子 窗口 都 可 以 放 在 主 窗口 容器 中 ， 这 个 容器 控件 被 称 为 
QMdiArea. 

QMidArea 控 件 通常 占据 在 QMainWindow 对 象 的 中 央 位 置 ， 子 窗口 
在 这 个 区 域 是 QMdiSubWindow 类 的 实例 ， 可 以 设置 任何 QWidget 作 为 子 
窗口 对 象 的 内 部 控件 ， 子 窗口 在 MDI 区 域 进行 级 联 排列 布局 。 

QMdiArea 类 和 QMdisubWindow 类 中 的 常用 方法 如 表 5-16 所 示 。 























表 5-16 
addSubWindow() 将 一 个 小 控件 添加 在 MDI 区 域 作为 一 个 新 的 子 窗口 
removeSub Window() 删除 一 个 子 窗口 中 的 小 控件 


setActiveSubWindow() 激活 一 个 子 窗 口 
cascadeSub Windows() 安排 子 窗口 在 MDI 区 域 级 联 显示 


tileSubWindows() 安排 子 窗口 在 MDI 区 域 平 铺 显示 
closeActiveSubWindow 关闭 活动 的 子 窗口 


subWindowList() 返回 MDI 区 域 的 子 窗口 列表 
setWidget() 设置 一 个 小 控件 作为 QMdiSubwindow 实例 对 象 的 内 部 控件 
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本 例文 件 名 为 PyQt5/ Chapter05/qt05_QMultipleDoc.py， 演 示 在 PyQt 
5 的 窗口 中 使 用 QMdiArea 控 件 。 其 完整 代码 如 下 : 


sub.setWindowTitle ("subwindow"+str (MainWindow.count)) 
self.mdi.addSubWindow (sub) 
sub.show () 
if q.text()=="cascade": 
self.mdi.cascadeSubWindows () 
if q.text()=="Tiled": 
self.mdi.tileSubWindows () 


if name ==" _main_': 
app = QApplication(sys.argv) 
demo = MainWindow () 
demo. show () 
sys.exit(app.exec_ ()) 


到 行 脚本 ， 显 示 效 果 如 图 5-36 所 示 。 


vi 


MDI demo 








图 5-36 


代码 分 析 : 
在 这 个 例子 中 ， 主 窗口 QMainWindow 拥 有 一 个 菜单 控件 和 MidArea 


控件 。 


= 


self.mdi=QMdiArea() 

self.setCentralWidget(self.mdi) 

bar=self.menuBar() 

file=bar.addMenu("File") 

file.addAction("New") 

file.addAction("cascade") 

file.addAction("Tiled") 

单 击 菜单 控件 时 触发 triggered 信 号 ， 连 接 到 覃 函数 





windowaction()。 


= 


有 标题 ， 


= 
口 的 排 


file.triggered[QAction].connect(self.windowaction) 
选择 表单 中 的 “New” 动 作 时 ， 会 添加 一 个 新 的 MDI， 每 个 MDI 都 
在 主 窗口 内 部 会 增加 MDI 的 数量 。 
MainWindow.count=MainWindow.count+1 
sub=QMdiSubWindow() 
sub.setWidget(QTextEdit()) 
sub.setWindowTitle("subwindow"+str(MainWindow.count)) 
self.mdi.addSubWindow(sub) 
sub.show() 
选择 菜单 中 的 “cascade” 和 “Tiled” 动 作 时 ， 会 在 主 窗口 中 显示 子 窗 
列 方式 一 一 级 联 显 示 子 窗口 或 平 铺 显 示 子 窗口 。 
if q.textQ=="cascade": 

self.mdi.cascadeSubWindows() 

if q.textQ=="Tiled": 
self.mdi.tileSubWindows() 








5.2.5 OScrollBar 


可 以 看 到 ， 前 面 介绍 的 几 个 窗口 控件 的 共同 点 是 新 建 一 些 窗口 来 装 
载 更 多 的 控件 ， 而 QScrollBar 提 供 了 另 一 种 思路 : 这 个 窗口 控件 提供 了 
水 平 的 或 垂直 的 滚动 条 ， 这 样 可 以 扩大 当前 窗口 的 有 效 装 载 面 积 ， 从 而 
装载 更 多 的 控件 。 

QScrollBar 类 中 的 常用 信号 如 表 5-17 所 示 。 








表 5-17 





案例 5-8 QScrollBar 


本 例文 件 名 为 PyQt5/Chapter05/gt05_QScrollBar.py， 演 示 在 PyQt 5 的 
窗口 中 使 用 QScrollbar 控 件 。 其 完整 代码 如 下 : 


import sys 

from PyQt5.QtCore import * 
from PyOQt5.QtGui import = 
from PyQt5.QtWidgets import * 


class Example (QWidget): 
def init (self): 
super(Example, self). init () 
self.initUI () 


def initUI (self): 
hbox = QHBoxLayout( ) 
self.11 = OLabel(" 拖 动 滑 块 改变 颜色 ") 
self.l1.setFont (QFont ("Arial",16) ) 
hbox.addWidget (self.11) 
self.sl = QScrollBar () 
self.sl.setMaximum (255) 
self.sl.sliderMoved.connect (self.sliderval) 
self.s2 = QScrollBar () 
self.s2.setMaximum (255) 
self.s2.sliderMoved.connect (self.sliderval) 
self.s3 = QScrollBar () 
self.s3.setMaximum(255) 
self.s3.sliderMoved.connect (self.sliderval) 
hbox.addWidget (self.s1) 
hbox.addWidget (self.s2) 
hbox.addWidget (self.s3) 
self.setGeometry(300, 300, 300, 200) 
self.setWindowTitle('QScrollBar 例子 ') 
self.setLayout( hbox ) 


def sliderval (self): 
print( self.sl.value(),self.s2.value(), self.s3.value() ) 
palette = OPalette() 
c=Q0Color(self.sl.value(),self.s2.value(), 
self.s3.value(),255) 
palette.setColor (QPalette. Foreground, c) 
self.11.setPalette (palette) 


if name == ' main _': 
app = QApplication(sys.argv) 
demo = Example () 
demo. show () 


sys.exit(app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 5-37 所 示 。 
| QScrollBar 例子 OR 





图 5-37 


代码 分 析 : 
在 这 个 例子 中 ， 设 置 了 三 个 滑动 条 来 控制 标签 中 所 显示 文字 的 字体 
颜色 的 RGB 值 。 
当 移 动 滑 块 时 ， 将 sliderMoved 信 号 与 模 函 数 sliderval0 连 接 起 来 。 


self.s1.sliderMoved.connect(self.sliderval) 








5.3 多 线程 


一 般 情 况 下 ， 应 用 程序 都 是 单线 程 运行 的 ， 但 是 对 于 GUI 程序 来 
说 ， 单 线程 有 时 候 满足 不 了 需求 。 比 如 ， 如 果 需 要 执行 一 个 特别 耗 时 的 
操作 ， 在 执行 过 程 中 整个 程序 就 会 卡 顿 ， 这 时 候 用 户 可 能 以 为 程序 出 
兰 ， 就 把 程序 关闭 了 ; 或 者 Windows 系 统 也 认为 程序 运行 出 错 ， 自 动 关 
闭 了 程序 。 要 解决 这 种 问题 束 涉 及 多 线程 的 知识 。 一 般 来 说 ， 多 线程 技 
术 涉 及 三 种 方法 ， 其 中 一 种 是 使 用 计时 器 模块 QTimer; 一 种 是 使 用 多 线 
程 模 块 QThread; 还 有 一 种 是 使 用 事件 处 理 的 功能 。 





5.3.1 QTimer 


如 果 要 在 应 用 程序 中 周期 性 地 进行 某 项 操作 ， 比 如 周期 性 地 检测 主 
机 的 “CPU 值 ， 则 需要 用 到 QTimer (定时 器 ) ，QTimer 类 提供 了 重复 的 
和 单 次 的 定时 器 。 要 使 用 定时 器 ， 需 要 先 创建 一 个 QTimer 实 例 ， 将 其 
timeout 信 号 连接 到 相应 的 槽 ， 并 调用 start)。 然 后 ， 定 时 器 会 以 恒定 的 
间隔 发 出 timeout 信 号 。 

当 窗 口 控 件 收 到 timeout 信 号 后 ， 它 就 会 停止 这 个 定时 器 。 这 是 在 图 
形 用 户 界 面 中 实现 复杂 工作 的 一 个 典型 方法 ， 随 着 技术 的 进步 ， 多 线程 
在 越 来 越 多 的 平台 上 被 使 用 ， 最 终 QTimer 对 象 会 被 线程 所 替代 。 

QTimer 类 中 的 常用 方法 如 表 5-18 所 示 。 








表 5-18 
5 法 描 R 


start(milliseconds) 启动 或 重新 启动 定时 器 ， 时 间 间 隔 为 毫秒 。 如 果 定 时 器 已 经 运行 ， 它 将 





被 停止 并 重新 启动 。 如 果 singleShot 信号 为 真 ， 定 时 器 将 仅 被 激活 一 次 





QTimer 类 中 的 常用 信号 如 表 5-19 所 示 。 


表 5-19 





首先 ， 需 要 引入 QTimer 模 块 。 
from PyQt5.QtCore import QTimer 
然后 ， 实 例 化 一 个 QTimer 对 象 ， 将 timeout 信 号 连接 到 operate0 模 函 
数 。start(2000) 表 示 设 置 时 间 间 隅 为 2 秒 并 局 动 定时 峰 。 
# 初始 化 一 个 定时 器 
self.timer=QTimer(self) 
# 计时 结束 调用 operate() 方 法 
# 设置 时 间 间 隔 并 局 动 定时 器 
self.timer.timeout.connect(self.operate) 


self.timer.start(2000) 





注意 
在 connect 中 operate 方 法 千 万 不 要 加 括号 ， 人 否则 会 出 错 。 
1. 示 例 1 


本 例文 件 名 为 PyQt5/Chapter05/qt05_timer01.py， 演 示 弹 出 的 窗口 在 
10 秒 后 消失 。 其 完整 代码 如 下 : 


from PyQt5.QtWidgets import QWidget, QPushButton , 
QApplication ,QListWidget, QOGridLayout , QLabel 
from PyQt5.QtCore import QTimer ,QDateTime 


import sys 
class WinForm(QWidget) : 


def init  (self,parent=None) : 


super (WinForm, self). init (parent) 


LE 


def 


def 


def 


name == " main 


self.setWindowTitle("QTimer demo") 
self.listFile= QListWidget () 
self.label = QLabel(' 显 示 当 前 时 间 ') 
self.startBtn = QPushButton(' 开 始 ') 
self.endBtn = QPushButton(' 结 来 ') 
layout = QGridLayout (self) 


# 初始 化 一 个 定时 器 
self.timer = QTimer (self) 
# showTime () 方法 


self.timer.timeout.connect (self.showTime) 


layout.addWidget (self.label,0,0,1,2) 
layout.addWidget (self.startBtn,1,0) 
layout.addWidget (self.endBtn,1,1) 


self.startBtn.clicked.connect( self.startTimer) 


self.endBtn.clicked.connect( self.endTimer) 


self.setLayout (layout) 


showTime (self): 

# 获取 系统 现在 的 时 间 

time = QDateTime.currentDateTime () 

# 设置 系统 时 间 显 示 格 式 

timeDisplay = time.toString ("yyyy-MM-dd hh:mm:ss dddd") ; 
# 在 标签 上 显示 时 间 

self.label.setText( timeDisplay ) 


startTimer (self): 

# 设置 时 间 间 隔 并 启动 定时 器 
self.timer.start (1000) 
self.startBtn.setEnabled (False) 
self.endBtn.setEnabled (True) 


endTimer (self): 
self.timer.stop () 
self.startBtn.setEnabled (True) 
self.endBtn.setEnabled (False) 


We 
. 





= QApplication(sys.argv) 


form = WinForm() 


form. show () 


Sys exile appncxee (0 


运行 脚本 ， 显 示 效 果 如 图 5-38 所 示 。 
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开始 ”| ”结束 





图 5-38 


代码 分 析 : 

首先 ， 初 始 化 一 个 定时 器 ， 把 定时 器 的 timeout 信号 与 showTime() 
槽 函数 连接 起 来 。 

self.timer=QTimer(self) 

self.timer.timeout.connect(self.showTime) 

使 用 连接 的 槽 函数 显示 当前 时 间 ， 并 在 标签 上 显示 系统 现在 的 时 
间 。 





def showTime(self): 
# 获取 系统 现在 的 时 间 
time=QDateTime.currentDateTime() 
# 设置 系统 时 间 显 示 格 式 
timeDisplay=time.toString("yyyy-MM-dd hh:mm:ss dddd"); 
# 在 标签 上 显示 时 间 
self.label.setText( timeDisplay ) 


单 击 “ 开 始 ” 按 钮 ， 启 动 定时 器 ， 并 使 “开始 ”按钮 失效 。 

# 设置 时 间 间 隔 并 局 动 定时 器 

self.timer.start(1000) 

self.startBtn.setEnabled(False) 

self.endBtn.setEnabled(True) 

单 击 “ 结 束 ” 按 钮 ， 停 止 定时 器 ， 并 使 “结束 ”按钮 失效 。 

self.timer.stop() 

self.startBtn.setEnabled(True) 

self.endBtn.setEnabled(False) 

2. 示 例 2 

本 例文 件 名 为 PyQt5/Chapter05/gt05_timer02.py， 演 示 弹 出 一 个 窗 
口 ， 然 后 这 个 窗口 在 10 秒 后 消失 。 其 完整 代码 如 下 。 


import sys 

from PyQt5.QtWidgets import * 
from PyQt5.QtGui import * 
from PyOt5.QtCore import * 


if fname == I main i; 
app = QApplication(sys.argv) 
label = QLabel ("<font color=red size=128><b>Hello PyQT, 窗口 会 在 10 
秒 后 消失 ! </b></font>") 
# 无 边框 窗口 
label.setWindowFlags (Qt.SplashScreen|Qt.FramelessWindowHint) 
label .show () 


# 设置 10 秒 后 自动 退出 
QTimer.singleShot(10000, app.quit) 


sys-exit{app- -exec Oh 


运行 脚本 ， 显 示 效 果 如 图 5-39 所 示 。 





Hello PyQT， 窗 口 会 在 10 秒 后 消失 ! 


图 5-39 





代码 分 析 : 
弹出 的 窗口 将 在 10 秒 后 消失 ， 模 仿 程序 的 局 动画 面 。 将 弹出 的 窗口 
设置 为 无 边框 。 
label.setWindowFlags(Qt.SplashScreen|Qt.FramelessWindowHint) 
使 用 QTimer 设 置 时 间 间 隅 ，10 秒 后 退出 程序 。 
QTimer.singleShot(10000,app.quit) 


5.3.2 OThread 


QThread 是 Qt 线程 类 中 最 核心 的 底层 类 。 由 于 PyQt 的 跨 平台 特 
性 ，QThread 要 隐藏 所 有 与 平台 相关 的 代码 。 

要 使 用 QThread 开始 一 个 线程 ， 可 以 创建 它 的 一 个 子 类 ， 然 后 罗 兰 
其 QThread.run0 函 数 。 


class Thread(QThread): 
def init (self): 


super (Thread, self). init () 


def run(self): 
# 线 程 相关 代码 
Pass 

接 下 来 创建 一 个 新 的 线程 。 

thread=Thread() 

thread. start() 
可 以 看 出 ，PyQt 的 线程 的 使 用 非常 简单 一 一 建立 一 个 自 定义 的 类 

(如 Thread) ， 使 它 继承 自 QThread， 并 实现 其 run(0) 方 法 即 可 。 





在 使 用 线程 时 可 以 直接 得 到 Thread 实 例 ， 调 用 其 start0 函 数 即 可 启 
动 线程 。 线 程 局 动 之 后 ， 会 自动 调用 其 实现 的 run 方 法 ， 访 方法 就 是 线 
程 的 执行 函数 。 

业务 的 线程 任务 就 写 在 run(0) 函 数 中 ， 当 run0 退 出 之 后 线程 基本 就 
结束 了 。QThread 有 started 和 finished 信号 ， 可 以 为 这 两 个 信号 指定 槽 
函数 ， 在 线程 启动 和 结束 时 执行 一 段 代 码 进行 资源 的 初始 化 和 释放 操 
作 。 更 灵活 的 使 用 方法 是 ， 在 自 定义 的 QThread 实 例 中 自 定 义 信 号 ， 并 
将 信号 连接 到 指定 的 槽 函数 ， 当 满足 一 定 的 业务 条 件 后 发 射 此 信号。 

1.QThread 类 中 的 常用 方法 和 信号 

QThread 类 中 的 常用 方法 如 表 5-20 所 示 。 











表 5-20 


启动 线程 
阻止 线程 ， 直 到 满足 如 下 条 件 之 一 : 
。 与 此 QThread 对 象 关联 的 线程 已 完成 执行 ( 即 从 run0 返 回 时 )。 如 果 线 程 





完成 执行 ， 此 函数 将 返回 True; 如 果 线 程 尚 未 启动 ， 此 函数 也 返回 True 
。 等 待 时 间 的 单位 是 毫秒 。 如 果 时 间 是 ULONG_MAX (默认 值 )， 则 等 待 ， 

永远 不 会 超时 (线程 必须 从 run0 返 回 ); 如 果 等 待 超 时 , 此 函数 将 返回 False 
强制 当前 线程 睡眠 秒 秒 。 


QThread 类 中 的 常用 信号 如 表 5-21 所 示 。 


表 5-21 





描 R 





started 在 开始 执行 run0 函 数 之 前 ， 从 相关 线程 发 射 此 信号 
当 程序 完成 业务 逻辑 时 ， 从 相关 线程 发 射 此 信和 号 

2.QThread 实 例 

当 在 窗口 中 显示 的 数据 比较 简单 时 ， 可 以 把 读 取 数据 的 业务 逻辑 放 
在 窗口 的 初始 化 代码 中 ; 但 如 果 读 取 数 据 的 时 间 比 较 长 ， 比 如 网 络 请 求 
数据 的 时 间 比 较 长 ， 则 可 以 把 这 部 分 逻辑 放 在 QThread 线 程 中 ， 实 现 界 
面 的 数据 显示 和 数据 读 取 的 分 离 ， 以 满足 MVC《〈 模 型 一 视图 一 控制 





器 ) 设计 模式 的 要 求 。 
本 例文 件 名 为 PyQt5/Chapter05/qt05_thread03.py， 演 示 弹 出 的 窗口 
只 显示 10 秒 ，10 秒 后 自动 消失 。 其 完整 代码 如 下 : 


def run (self): 
while self.working == True: 

file str = 'File index {0}".format(self.num) 
self.num += 1 
# 发 射 信号 
self.sinOut.emit (file str) 
# 线程 休眠 2 秒 
self.sleep (2) 


if _ name == T main "s 
app = QApplication(sys.argv) 
demo = MainWidget () 
demo. show () 


sys.exit (app.exec_ ()) 


运行 脚本 ， 显 示 效 果 如 图 5-40 所 示 。 


File index 0 
File index 1 
File index 2 
File index 3 


File index 4 
File index 5 





图 5-40 


代码 分 析 : 


在 这 个 例子 中 ， 单 击 “ 开 始 ? 按 钮 ， 会 在 后 台 定 时 读 取 数 据 ， 并 把 返 
回 的 数据 显示 在 界面 中 。 首 先 使 用 以 下 代码 进行 布局 ， 把 列表 控件 和 按 
钮 控件 放 在 栅 格 布局 管理 妖 中 。 
self.listFile=QListWidget() 
self.btnStart=QPushButton(‘Jt 47’) 
layout=QGridLayout(self) 
layout.addWidget(self.listFile,0,0,1,2) 
layout.addWidget(self.btnStart, 1,1) 
然后 将 按钮 的 ”dlicked 信号 连接 到 slotStart0 槽 函数， 当 单 击 “ 开 
始 ? 按 钮 时 发 射 此 信和 号。 
self.btnStart.clicked.connect( self.slotStart ) 
def slotStart(self): 
self.btnStart.setEnabled(False) 
self.thread.start() 
比较 复杂 的 是 线程 的 信号 ， 将 线程 的 sinOut 信号 连接 到 slotAdd() 
槽 函数 。slotAddO 函 数 负责 在 列表 控件 中 动态 添加 字符 串 条 目 。 
self.thread.sinOut.connect(self.slotAdd) 
def slotAdd(self,file_inf): 
self.listFile.addItem(file_inf) 
定义 一 个 线程 类 ， 继 承 自 QThread 类 ， 当 线程 启动 后 ， 执 行 run0) 函 
数 。 











class Worker (QThread) : 


sinOut = pyqtSignal (str) 


def 


def 


在 上 一 个 例子 中 ， 虽 然 解决 了 界面 的 数据 显示 和 数据 读 取 的 分 离 ， 
但 是 如 果 数 据 的 读 取 非 第 耗费 时 间 ， 则 会 造成 界面 卡 死 。 接 下 来 ， 让 我 


__init (self,parent=None): 
super (Worker,self). init (parent) 
self.working = True 


self.num = 0 


det (Sern: 
self.working = False 


self.wait () 


run(self): 


while self.working == True: 


file str = "File index {0}".format (self .num) 


self.num += 1 
# 发 射 信号 
Solr ys NOUE emma: (Ee Sy 


# 线程 休眠 2 秒 
self.sleep (2) 


们 看 一 介 需 要 耗费 很 长 时 间 读 取 数 据 的 例子 。 


本 例文 件 名 为 PyQt5/Chapter05/qt05_thread01.py， 演 示 长 时 间 读 取 


数据 造成 界面 卡 死 。 其 完整 代码 如 下 : 


import sys 


运行 脚本 ， 显 示 效 果 如 图 5-41 所 示 。 





图 5-41 


在 这 个 例子 中 ， 在 主 界面 中 有 一 个 用 于 显示 时 间 的 ”LCD 数字 面 
板 ， 还 有 一 个 用 于 启动 任务 的 按钮 。 用 户 单 击 “测试 ”按钮 后 ， 将 开始 一 
次 非常 耗 时 的 计算 〈 在 程序 中 用 一 个 2 000 000 000 次 的 循环 来 模拟 这 
次 非常 耗 时 的 工作 ， 在 真实 的 程序 中 可 能 是 一 个 网 络 下 载 操作 ， 从 网 络 
上 下 载 一 个 很 大 的 视频 文件 ) ， 同 时 ”LCD 数字 面板 开始 显示 所 用 的 富 
秒 数 ， 并 通过 一 个 计时 器 进行 更 新 。 计 算 完 成 后 ， 计 时 器 停止 。 这 是 一 
个 很 简单 的 应 用 ， 也 看 不 出 有 任何 问题 。 但 是 当 开 始 运行 程序 时 ， 问 题 
就 来 了 : 单 击 “ 测 试 ? 按 钮 之 后 ， 程 序 界面 直接 停止 啊 应 ， 直 到 循环 结束 
才 开 始 重 新 更 新 ， 于 是 计时 器 始终 显示 0。 

在 PyQt 中 所 有 的 窗口 都 在 UI 主线 程 中 《就 是 执行 了 
QApplication.exec() 的 线程 》， 在 这 个 线程 中 执行 耗 时 的 操作 会 阻塞 ”UI 
线程 ， 从 而 让 窗口 停止 啊 应 。 如 采 窗 口 长 时 间 没 有 啊 应 ， 则 会 影响 用 户 
体验 ， 更 严重 的 会 导致 程序 崩 尝 。 所 以 ， 为 了 避免 出 现 这 样 的 问题 ， 要 
使 用 QThread 开 局 一 个 新 的 线程 ， 在 这 个 线程 中 完成 耗 时 的 操作 。 

案例 5-9 应 用 案例 : 分 离 UI 主 线程 与 工作 线程 
本 例文 件 名 为 PyQt5/Chapter05/qt05_thread02.py， 演 示 在 界面 中 分 











离 UI 主 线程 与 工作 线程 。 其 完整 代码 如 下 : 





button.clicked.connect (work) 
# 每 次 计时 结束 ， 和 触发 countTime 


timer.timeout.connect (countTime) 


top. show () 


sys exit(app-exec ()) 


EXMA P, 4 y —NWorkerThread%. WorkerThread#t 7 Á 
QThread 类 ， 重 写 了 其 mn0 函 数 。 可 以 认为 ，run0) 函 数 就 是 新 的 线程 需 
要 执行 的 ， 在 run() 函 数 中 束 是 要 执行 一 个 循环 ， 然 后 发 射 计算 完成 的 信 
与。 而 在 单 击 按钮 的 槽 函数 中 ， 使 用 workO) 中 的 workThread.start() 水 数 
启动 一 个 线程 (注意 ， 不 是 run() 阔 数 ) 。 再 次 运行 程序 ， 发 现 界 面 有 了 
响应 。 

运行 结果 如 图 5-42 所 示 。 








5.3.3 ER 


PyQt 为 事件 处 理 提供 了 两 种 机 制 : 高 级 的 信号 与 槽 机 制 ， 以 及 低级 
的 事件 处 理 程序 。 本 节 只 介绍 低级 的 事件 处 理 程序 ， 即 ”processEvents() 


函数 的 使 用 方法 ， 它 的 作用 是 处 理事 件 ， 简 单 地 说 ， 就 是 刷新 页 面 。 

对 于 执行 很 耗 时 的 程序 来 说 ， 由 于 PyQt 需要 等 竺 程序 执行 完毕 才 
能 进行 下 一 步 ， 这 个 过 程 表 现在 界面 上 就 是 卡 顿 ;而 如 条 在 执行 这 个 耗 
时 程序 时 不 断 地 运行 QApplication.processEvents()， 那 么 就 可 以 实现 一 边 
执行 耗 时 程序 ， 一 边 刷新 页 面 的 功能 ， 给 人 的 感觉 就 是 程序 运行 很 流 
畅 。 因 此 QApplication.processEvents() 的 使 用 方法 束 是 ， 在 主 函 数 执行 耗 
时 操作 的 地 方 ， 加 入 QApplication.processEvents()。 

本 例文 件 名 为 PyQt5/Chapter05/qt05_freshUi.py， 演 示 实 时 刷新 页 
面 。 其 完整 代码 如 下 : 























from PyQt5.0tWidgets import QWidget, QPushButton , 
QApplication ,QListWidget, QGridLayout 





运行 脚本 ， 显 示 效 果 如 图 5-43 所 示 。 


File index 0 
File index 1 
File index 2 
File index 3 


File index 4 
File index 5 
File index 6 
File index 7 





图 5-43 


5.4 网 页 交互 


PyQt 5 使 用 QWebEngineView 控 件 来 展示 HTML 页 面 ， 对 老 版 本 中 
的 QWebView 类 不 再 进行 维护 ， 因 为 QWebEngineView 使 用 Chromium 
内 核 可 以 给 用 户 帝 来 更 好 的 体验 。 

Qt 慢 慢 淘汰 了 古老 的 WebKit， 取 而 代 之 的 是 使 用 WebEngine 框 架 。 
WebEngine 是 基于 谷歌 的 Chromium 引擎 开发 的 ， 也 束 是 内 部 集成 了 谷 
WHJ Chromium 引擎 。WebEngine 框 架 是 基于 Chromium 上 的 Content API 
封装 ， 投 入 成 本 比较 小 ， 可 以 很 好 地 文 持 HIML 5。 

在 PyQt 5 中 可 以 通过 PyQt5.QtWebKitWidgets.QWebEngineView 类 来 
使 用 网 页 控件 ， 此 类 定义 如 下 : 





QObject 
| 
+- QLayout 
| 
+- QWidget 
| 
+- QWebEngineView 





QWebEngineView 类 中 的 第 用 方法 如 表 5-22 所 示 。 


表 5-22 


load(QUrl url) 加 载 指定 的 URL 并 显示 








setHtml(QString &html) 将 网 页 视图 的 内 容 设置 为 指定 的 HTML 内 容 

QWebEngineView 控件 使 用 load0 函 数 加 载 一 个 Web 页面， 实际 上 
就 是 使 用 HTTP GET 方法 加 载 Web 页 面 。 这 个 控件 既 可 以 加 载 本 地 的 
Web 页 面 ， 也 可 以 加 载 远 程 的 外 部 Web 页 面 ， 其 核心 代码 如 下 : 


view=QWebEngineView() 
view.load(QUrl(‘http://www.cnblogs.com/wangshuo1/")) view.show() 


QWebEngineView 控 件 还 可 以 使 用 setHtml0 函 数 加 载 本 地 的 Web 代 


位 o 
案例 5-10 并 显示 外 部 的 Web 页 
本 例文 件 名 为 PyQt5/Chapter05/qt05_webview01.py， 演 示 在 


QWebEngineView 中 加 载 外 部 的 Web 页 面 。 其 完整 代码 如 下 : 





运行 脚本 ， 显 示 效 果 如 图 5-44 所 示 。 
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案例 5-11 并 显示 本 地 的 Web 页 


本 例文 件 名 为 PyQt5/Chapter05/qt05_webview02.py， 演 示 在 
QWebEngineView 中 加 载 本 地 的 Web 页 面 。 其 完整 代码 如 下 : 


from PyOt5.QtCore import * 

from PyOQt5.QtGui import * 

from PyQt5.QtWidgets import * 

from PyQt5.QtWebEngineWidgets import * 


import sys 


class MainWindow (QMainWindow) : 


def inie (self $i 
super (QMainWindow, self). init () 
self.setWindowTitle (' 加 载 并 显示 本 地 页 面 例 子 ') 
self.setGeometry(5, 30, 555, 330) 
self.browser = QWebEngineView () 
# 加 载 本 地 页 面 
url = r'E:/quant/PyQt5/Chapter05/index.html1' 
self. browser.load( QUrl( url J) 
self.setCentralWidget (self.browser) 


if _ name _ == 1_ main ': 
app = QApplication(sys.argv) 
win = MainWindow() 
win. show() 


sys.exit(app.exec_()) 


上 面 代码 中 加 载 的 index.html 页 面 ， 是 按照 HTML 5 规 


的 代码 如 下 : 


<!DOCTYPE html> 

<html> 

<head> 
<meta charset="UTF-8"> 
<title></title> 

</head> 

<body> 
<hl>Hello PyQt5</h1> 
<hl>Hello PyQt5</h1> 
<hl>hello PyQt5</h1> 


<hl>hello PyQt5</h1> 
<hl>hello PyQt5</h1> 
<hl>Hello PyQt5</h1> 

</body> 

</html> 


运行 脚本 ， 显 示 效 末 如 图 5-45 所 示 。 











加 载 并 显示 本 地 页 面 例子 - OES 
Hello PyQt5 

Hello PyQt5 

hello PyQts 

hello PyQts5 

hello PyQt5 

Hello PyQtS 

图 5-45 


案例 5-12 并 显示 先入 的 HIML 代 三 


本 例文 件 名 为 PyQt5/Chapter05/qt05_webview03.py， 演 示 在 
QWebEngineView 中 加 载 并 显示 磐 入 的 HTML 代码 ， 就 是 把 案例 5-11 
中 加 载 的 本 地 页 面 ipdex.html 的 代码 巷 入 到 PyQt 脚 本 中 。 本 例 的 完整 代 


码 如 下 : 





self.browser = QWebEngineView () 
# 加 载 HTML 代码 
self.browser = QWebEngineView () 
self.browser.setHtml(''' 
<!DOCTYPE html> 
<html> 
<head> 
<meta charset="UTF-8"> 
<title></title> 
</head> 
<body> 
<hl>Hello PyQt5</h1> 
<hi>Hello PyQt5</h1> 
<hl>hello PyQt5</hl1> 
<hl>hello PyQt5</h1> 
<hl>hello PyQt5</h1> 
<hl>Hello PyQt5</h1> 


</body> 
</html> 


self.setCentralWidget (self.browser) 


if _ name == ' main ': 
app = QApplication(sys.argv) 
win = MainWindow() 
win.show() 


sys.exit(app.exec ()) 


运行 脚本 ， 显 示 效 果 和 图 5-45 一 致 ， 这 里 不 再 重复 。 

注意 

经 过 测试 ， 使 用 QWebEngineView 对 象 的 setHtml0 函 数 泻 染 HTML 
页 面 时 ， 如 果 页 面 中 使 用 的 JavaScript 代 码 超过 2MB， 程 序 泻 染 的 页 面 
就 会 演 染 失败 ， 页 面 中 会 出 现 大 厂 的 空白 ， 详 罗 QTBUG-53414 


QtWebEngineView fails to load huge page。 感 兴趣 的 读者 可 以 访问 
https://bugreports.qt.io/browse/QTBUG-53414， 查 看 Bug 信 息 和 官方 反 


== 
馈 。 





通过 QWebEnginePage 类 的 runJavaScript(strCallable) 函 数 可 以 很 方 
便 地 实现 PyQt 和 HTML/JavaScript 的 双 辐 通信 ， 也 实现 了 Python 代码 和 
HTML/JavaScript 代 码 的 解 炸 ， 便 于 开发 人 员 进 行 分 工 协 作 。 在 PyQt 对 
象 中 访问 JavaScript 的 核心 代码 如 下 : 
QWebEnginePag.runJavaScript(str,Callable) 
本 例文 件 名 为 PyQt5/Chapter05/qt502_webviewJs01.py， 其 完整 代码 
如 下 : 


运行 脚本 ， 显 示 效 果 如 图 5-46、 图 5-47 和 图 5-48 所 示 。 


mi Web 页 面 中 的 JavaScript 与 QWebEngineView 交 互 例子 





First name: | 
Last name: | 
Full name: 











图 5-46 





Web 页 面 中 的 JavaScript 与 QWebEngineView 交 互 例子 一 Oo 





First name: zhang 
Last name: |san 
Full name: |zhang san | 


EES 














图 5-47 








z Web 页 面 中 的 JavaScript 与 QWebEngineView 交 互 例子 - O ES 
First name 
Last name 
Full name 
?fname=zhang&lname=san 
设置 全 名 
图 5-48 
代码 分 析 : 


在 本 例 中 ， 初 始 化 一 个 QWebEngineView 对象， 对 象 名称 为 
View， 然 后 通过 view.page() 函 数 获得 一 个 QWebEnginePage 对 象 ， 就 可 
以 访问 整个 Web 页面 了 。 这 个 QWebEnginePage 对 象 有 一 个 异步 的 
runJavaScript() 疯 数 ， 需 要 一 个 回调 函数 接收 结果 。 其 核心 代码 如 下 : 

def js_callback(result): 
print(result) 
def complete_name(): 


view.page().runJavaScript(‘completeAndReturnName();',js_callback 








JavaScript 调 用 PyQt 代 码 ， 是 指 PyQt 可 以 与 加 载 的 Web 页 面 进行 双 问 
的 数据 交互 。 首 先 ， 使 用 QWebEngineView 对 象 加 载 Web 页 面 后 ， 就 可 
以 获得 页 面 中 表单 输入 数据 ， 在 Web 页 面 中 通过 JavaScript 代 码 收集 用 户 
提交 的 数据 。 然 后 ， 在 web 页 面 中 ，JavaScript 通 过 桥 连接 方式 传递 数据 
给 PyQt。 最 后 ，PyQt 接 收 到 页 面 传递 的 数据 ， 经 过 业务 处 理 后 ， 还 可 以 
把 处 理 过 的 数据 返 给 Web 页 面 。 
1. 创 建 QWebChannel 对 象 
创建 QWebChannel 对 象 ， 注 册 一 个 需要 桥接 的 对 象 ， 以 便 Web 页 面 
的 JavaScript 使 用 。 其 核心 代码 如 下 : 
channel=QWebChannel() 
myObj=MySharedObject() 
channel.registerObject( "bridge" ,myObj ) 





view.page().setWebChannel(channel) 
2. 创 建 共享 数据 的 PyQt 对 象 
创建 的 共享 对 象 需要 继承 QWidget 对 象 或 QObject 对 象 ， 其 核心 代码 
如 下 : 
class MySharedObject(QWidget): 
def init__(self): 
super( MySharedObject,self). init__Q) 
def _setStrValue( self,str ): 
print(' 获 得 页 面 参数 : %s'% str ) 
# 需要 定义 对 外 发 布 的 方法 
strValue=pyqtProperty(str,fset=_setStrValue) 
注意 


对 外 提供 的 PyQt 对 象 方法 ， 需 要 使 用 pyqtProperty0 函 数 让 和 它 骏 露出 


来 。 

在 PyQt 5 中 使 用 pyqtProperty0 函 数 来 定义 PyQt 对 象 中 的 属性 ， 这 个 
函数 的 使 用 方式 与 标准 Python 模块 中 的 propertyO 函 数 相同 。 
PyQt5.QtCore.pyqtProperty() K BA APIU T : 

PyQt5.QtCore.pyqtProperty(type[,fget=None[,fset=None[,freset=None 


pyqtProperty 函 数 的 参数 说 明 如 表 5-23 上 所 示 。 


表 5-23 


， 属 性 的 类 型 
选 ， 用 于 获取 属性 的 值 
先 ， 用 于 设置 属性 的 值 
先 ， 用 于 将 属性 的 值 重 置 为 它 的 默认 值 
先 ， 用 于 删除 属性 


选 ， 设 置 Qt DESIGNABLE 标志 
可 选 ， 设 置 Qt SCRIPTABLE 标志 


notify 选 ， 未 绑 定 的 通知 信和 号 
revision 可 选 ， 将 版 本 导出 到 QML 
可 以 使 用 PyqtProperty0 函 数 给 类 的 属性 赋值 ， 作 为 参数 传 入 类 的 


setter 和 getter 方 法 名 。 以 下 是 PyqtProperty0 函 数 的 测试 用 例 ， 文 件 名 为 
PyQt5/Chapter05/qt05_property.py。 











from PyQt5.QtCore import QObject, pyqtProperty 


class MyObject (QObject): 
def init (self, inVal=20): 
self.val = inVal 


def readVal (self): 
print ('readVal=%s' % self.val ) 


return self.val 


def setVal(self,val): 


print ('setVal=%s' % val ) 


self.val = val 


ppVal = pyqtProperty(int, readVal, setVal ) 


if name == ' main ': 
obj = MyObject () 
prank ( NAEL?) 
obj .PPVal = 10 
print ('\n#2') 
print( 'obj.ppVal=%s' 





% obj.ppVal J 
print( 'obj.readVal()=%s' % obj.readVal() ) 


运行 脚本 ， 得 到 的 结果 如 下 : 
#1 
setVal=10 
#2 
readVal=10 
obj.ppVal=10 
readVal=10 
obj.readVal()=10 
3. 创 建 调用 PyQt 的 Web 页 面 
本 例 中 加 载 的 Web 页 面 是 index.html， 需 要 将 这 个 页 面部 署 到 服务 
器 上 ， 通 过 http://IP:Port/index.html] 的 形式 访问 。 可 以 使 用 HBuilder 新 


建 Web 项 目 ， 然 后 使 用 其 内 置 的 服务 器 访问 index.html。 
Web 页 面 index.html 的 保存 路 径 为 
PyQt5/Chapter05/web/index.html， 其 完整 代码 如 下 : 


function onShowMsgBox() { 


//alert ('window.bridge=' + window.bridge) ; 


if ( window.bridge) { 
var fname = document.getElementById('fname') .value; 


window.bridge.strValue = fname; 


</script> 
</head> 


<body> 
<form> 
<label for=" 姓 名 ">user name:</label> 
<input type="text" name="fname" id="fname"></input> 
<br /> 
<input type="button" value=" 传 递 参 数 到 pygt" 
onclick="onShowMsgBox () "> 
<input type="reset" value='#H'/> 
</form> 
</body> 
</html> 





首先 ， 需 要 在 页 面 中 引入 qwebchannel.js 脚 本 ， 这 个 脚本 是 Qt 官方 提 
供 的 ， 它 的 下 载 地 址 是 : 
https://code.csdn.net/tujiaw/webengineview/tree/master/qwebchannel.js. 

< script src="./qwebchannel.js" > < /script > 

其 次 ， 需 要 在 Web 页 面 中 访问 在 PyQt 中 注册 的 对 象 ， 获 得 
channel.objects.bridge 共 享 对 象 ， 其 中 bridge 是 在 PyQt 中 注册 共享 对 象 时 
用 到 的 名 字 。 其 核心 代码 如 下 : 

document.addEventListener("DOMContentLoaded",function () { 
new QWebChannel( gt.webChannelTransport,function(channel) { 


window.bridge=channel.objects.bridge; 
}; 
}); 
4. 实 例 
本 例文 件 名 为 PyQt5/Chapter05/qt502_webviewJs02.py， 其 完整 代码 
如 下 : 
from PyQt5.QtWidgets import QApplication ,QWidget 
,QVBoxLayout 
from PyQt5.QtWebEngineWidgets import QWebEngineView 
from PyQt5.QtCore import QUrl 
from MySharedObject import MySharedObject 
from PyQt5.QtWebChannel import QWebChannel 
import sys 
# 创建 一 个 应 用 实例 
app=QApplication(sys.argv) 
win=QWidget() 
win.setWindowTitle(CWeb 页 面 中 的 JavaScript 与 QWebEngineView 
交互 例子 
# 创建 一 个 垂直 布局 器 
layout=QVBoxLayout() 
win.setLayout(layout) 
# 创建 一 个 QWebEngineView 对 象 
view=QWebEngineView() 
html Url="http://127.0.0.1:8020/web/index.html' 
view.load( QUrl( htmlUr! )) 
# 创建 一 个 QWebChannel 对 象 ， 用 来 传递 PyQt 的 参数 到 JavaScript 
channel=QWebChannel( ) 


myObj=MySharedObject() 

channel.registerObject( "bridge" ,myObj ) 
view.page().setWebChannel(channel) 

# 把 QWebEngineView 控 件 和 button 控 件 加 载 到 layout 布 局 中 
layout.addWidget(view) 

# 显示 窗口 和 运行 应 用 





win.show() 
sys.exit(app.exec_()) 
需要 传递 自 定 义 类 MySharedObject， 这 个 自 定 义 类 继承 了 PyQt 中 
的 QWidget 类 。 它 的 代码 如 下 : 





from PyQt5.0tCore import QObject 
from PyQt5.QtCore import pyqtProperty 
from PyQt5.QtWidgets import QWidget, QMessageBox 


class MySharedObject (QWidget) : 


def. tait ( self): 
super( MySharedObject, self). init  () 


def (getstrvalue( serf): 
# 设置 参数 


return '100' 


det SSeS ot nValue selt; SEE S 
# 获得 参数 
print (' 获 得 页 面 参数 : $s'% str ) 
QMessageBox.information (self, "Information"，' 获 得 页 面 参 数 ; %s'% 


str ) 


# 需要 定义 对 外 发 布 的 方法 
strValue = pygtProperty(str, fget= getStrvalue, fset= setStrValue) 


注意 

自 定义 的 MySharedObject 类 要 继承 自 QWidget 基 础 控件 类 ， 才 可 以 
调用 PyQt 控 件 。 如 果 只 是 传递 数据 ， 仅 仅 是 Python 的 基本 数据 类 型 ， 
不 需要 调用 PyQt 控件 ， 那 么 自 定义 类 MySharedObject 继 承 QObject 类 就 
可 以 了 。 

运行 脚本 ， 显 示 效 果 如 图 5-49、 图 5-50 所 示 。 
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图 5-49 





| mi Web 页 面 中 的 JavaScript 与 QWebEngineView 交 互 例子 一 o 


user name: wangwu 


| 传递 参数 到 pyqt | | 重 置 | 


mi Information Ea 


@ 获得 页 面 参数 : wangwu 


OK 








图 5-50 


案例 5-13 和 案例 5-14 演 示 的 是 使 用 QWebEngineView 类 加 载 Web 页 
面 ， 在 页 面 中 输入 数据 ， 并 通过 QWebChannel 对 象 获得 页 面 提 交 的 数 
据 。 





6.1 好 软件 的 三 个 维度 


笔者 拥有 多 年 的 软件 开发 经 验 ， 既 开发 过 面向 企业 的 商业 软件 ， 也 
开发 过 面 回 大 众 的 开源 软件 。 本 世 笔 者 将 结合 自己 的 实际 工作 经 验 ， 和 
大 家 分 享 开发 软件 的 心得 。 

根据 软件 在 市 场 上 的 受 欢迎 程度 ， 发 现成 功 的 软件 在 用 户 体验 方面 
有 三 个 主要 维度 : 能 用 、 易 用 和 好 用 ， 如 图 6-1 所 示 。 








“能 用 ”维度 : 这 是 最 基本 也 是 最 重要 的 衡量 标准 ， 主 要 用 来 衡量 产 


品 需求 是 个 合理 ， 方 问 是 侣 正确 。 如 果 需 求 不 对 ， 产 品 的 可 用 性 惑 为 
零 ， 那 么 设计 的 软件 再 酷 炉 也 是 无 用 的 ， 更 别提 筷 的 易 用 和 好 用 了 。 
“ 易 用 ”维度 : 主要 看 软件 的 布局 管理 架构 是 否 合理 ， 能 人 否 快速 找到 
想 要 的 东西 ， 整 个 交互 流程 是 人 否 清 晰 ， Fue LA 














香 出 现 卡 顿 。 比 如 | 用 户 要 使 用 软件 的 茶 个 功能 ， 需 要 点 击 几 下 鼠标 和 
侣 击 儿 次 键盘 ， 以 及 这 些 步 又 是 否 都 是 必要 的 ， 有 没有 让 用 户 感到 大 
烦 。 


“好 用 ”维度 : 一 个 友好 、 人 性 化 的 软件 界面 ， 会 使 用 户 对 所 使 用 的 
软件 充满 好 感 。 比 如 苹果 的 Mac OS 操作 系统 在 这 方面 就 很 值得 借鉴 。 

三 个 维度 的 重要 程度 是 : 好 用 二 易 用 二 能 用 。 很 明显 “好 用 ”维度 是 
最 重要 的 ， 要 满足 软件 的 “好 用 ?维度 ， 首 先 必 须 满足 它 的 “ 易 用 ”和 ?能 
用 ”维度 。 在 初期 同类 软件 缺失 的 情况 下 ， 如 果 一 个 软件 能 满足 大 部 分 
用 户 的 需求 ， 那 么 它 的 下 载 量 就 会 大 增 。 当 市 场 上 出 现 大 量 同类 软件 
时 ， 如 果 这 个 软件 没有 自己 的 特色 ， 它 的 市 场 就 会 逐渐 被 同类 软件 
所 “看 食 %。 这 里 所 说 的 特色 就 是 指 “ 好 用 ”。 

在 目前 的 软件 开发 过 程 中 ， 图 形 用 户 界 面 GUI) 的 设计 相当 重 
要 。 美 观 、 易 用 的 软件 界面 能 够 让 用 户 使 用 时 更 加 舒服 ， 可 以 在 很 大 程 
度 上 提高 软件 的 使 用 量 。 

在 图 形 用 户 界面 中 ， 布 局 管理 是 一 个 重要 的 设计 方面 。 布 局 管理 是 
通过 布局 将 各 种 不 同 功 能 的 控件 (Widget〉 放 到 程序 主 窗口 中 ， 我 们 常 
用 的 软件 就 是 采用 布局 省 理 方式 来 进行 界面 设计 的 。 比 如 Python 集成 
开发 环境 Spyder 的 界面 由 许多 窗 格 组 成 ， 用 户 可 以 根据 自己 的 喜好 调 
整 它们 的 位 置 和 大 小 。 当 多 个 窗 格 出 现在 同一 个 区 域 时 ， 可 以 使 用 标签 
页 的 形式 来 显示 。 由 于 Spyder 的 界面 布局 合理 、 功 能 强大 、 用 户 体 验 
好 ， 所 以 深 受 广大 Python 极 客 的 欢迎 。Spyder 的 界面 如 图 6-2 所 示 。 
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In [3]: reset 


Once deleted, variables cannot be recovered. Proceed (y/[n])? y 


In [4]: runfile('E:/test.py', wiir="E:') 
hello pyqt 


In [5]: 











| Python console | History log IPython console 





图 6-2 








对 PyQt 5 的 界面 进行 布局 管理 主要 有 两 种 方法 ， 即 采用 绝对 位 置 和 
布局 类 。 在 PyQt 5 中 有 四 种 布局 方式 ， 即 水 平 布局 、 垂 直 布 局 、 网 格 布 
局 、 表 单 布 局 ， 以 及 两 种 布局 方法 ， 即 addLayoutO0 和 addWidget(), 
中 addLayoutO 用 于 在 布局 中 插入 子 布 局 ，addWidgetO 用 于 在 布局 中 插 
入 控件 。 

四 种 布局 方式 对 应 四 个 布局 类 : 

e 水 平 布 局 类 (QHBoxLayout)， 可 以 把 所 添加 的 控件 在 水 平方 同 
上 依次 排列 。 

e 垂直 布局 类 (QVBoxLayout) ， 可 以 把 所 添加 的 控件 在 垂直 方 同 
上 依次 排列 。 

e 网 格 布局 类 CQGridLayout) ， 可 以 把 所 添加 的 控件 以 网 格 的 形 
式 排 列 。 

e 表单 布局 类 (QFormLayout) ， 可 以 把 所 添加 的 控件 以 两 列 的 形 
式 排 列 。 

在 窗口 中 进行 单一 的 布局 并 不 难 ， 但 知 是 进行 比较 复杂 的 布局 ， 就 
涉及 布局 的 符 套 了 ， 推 荐 使 用 Qt Designer 的 可 视 化 管理 工具 来 进行 界面 
布局 。 

布局 类 及 其 子 类 的 继承 关系 如 图 6-3 所 示 。 














QHBoxLayout 


QVBoxLayout 


QGridLayout 





图 6-3 





绝对 位 置 布局 (Absolute Positioning Layout) 主要 是 通过 在 窗口 程 
序 中 指定 每 一 个 控件 的 显示 坐标 和 大 小 来 实现 的 。 最 开始 的 坐标 在 左上 
角 (0,0) 的 位 置 ， 以 (0,0) 为 原点 定位 窗口 某 一 点 的 具体 位 置 。 显 示 坐 标的 
表示 方法 是 (xy)，x 是 横 坐 标 ， 从 左 到 右 变 化 ; y 是 纵 坐 标 ， 从 上 到 下 
变化 。 在 绝对 位 置 布局 中 ， 窗 口中 的 控件 采用 绝对 位 置 进行 布局 。 

本 例文 件 名 为 PyQt5/Chapter06/qt06_absoPosition.py， 演 示 在 PyQt 5 
的 窗口 中 采用 绝对 位 置 进行 布局 。 其 完整 代码 如 下 : 











import sys 


from PyQt5.0tWidgets import QWidget, QLabel, QApplication 


class Example (QWidget) : 
det amit (Cern; 
super(). init () 
self.initUI () 


def initUI (self): 


TLI = QLabel (RKA, self) 
lbl1.move(15, 10) 


1b12 = QLabel('¥3', self) 
1lb12.move(35, 40) 


1b13 = QLabel('PyQt5 !"', self) 
1b13.move(55, 70) 


self.setGeometry (300, 300, 320, 120) 
self.setWindowTitle(' 绝 对 位 置 布 局 例子 ') 


if mame == Y main z 
app = QApplication(sys.argv) 
demo = Example () 
demo. show () 
sys.exit(app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 6-4 所 示 。 





代码 分 析 : 
在 这 个 例子 中 ， 使 用 move() 方 法 来 定位 控件 。 其 中 第 一 个 标签 控件 
定位 在 x=15,y=10 的 位 置 。 定 位 控件 使 用 x 和 y 坐 标 轴 。 
lbl1=QLabel(' 欢 迎 ',self) 
]b11.move(15,10) 





绝对 位 置 布局 的 优点 如 下 : 

o 可 以 直接 定位 每 个 控件 的 位 置 。 

绝对 位 置 布局 的 缺点 如 下 : 

e 如 果 改 变 一 个 窗口 的 大 小 ， 窗 口中 控件 的 大 小 和 位 置 不 会 随 之 改 





e 所 生成 的 窗口 在 不 同 的 操作 系统 下 看 起 来 可 能 不 一 样 。 

o 在 程序 中 改变 字体 时 可 能 会 破坏 布局 。 

o 如 有 果 修改 布局 ， 比 如 新 增 一 个 控件 ， 就 必须 全 部 重新 布局 ， 既 烦 
BC RT 





6.4 QBoxLayout (İE ) 


采用 QBoxLayonut 类 可 以 在 水 平和 垂直 方 回 上 排列 控件 ， 
QHBoxLayout 和 QVBoxLayout 类 继承 自 QBoxLayout 类 。 


6.4.1 QHBoxLayout 〈 水 平 布局 ) 





采用 QHBoxLayout 类 ， 按 照 从 左 到 右 的 顺序 来 添加 控件 。 
QHBoxLayout 类 中 的 常用 方法 如 表 6-1 所 示 。 





表 6-1 





addLayout(self, QLayout, stretch = 0) 在 窗口 的 右边 添加 布局 ,使 用 stretch (伸缩 量 ) 进行 伸缩 ， 

伸缩 量 默认 为 0 

addWidget(self, QWidget, stretch, Qt.Alignment alignment) 在 布局 中 添加 控件 : 

stretch 伸缩 量 )， 只 适用 于 QBoxLayout， 控 件 和 窗口 
会 随 着 伸缩 量 的 变 大 而 增 大 

ealignment， 指 定 对 齐 的 方式 








addSpacing(self, int) 设置 各 控件 的 上 下 间距 ,通过 该 方法 可 以 增加 额外 的 空间 


QHBoxLayout 类 的 继承 结构 如 下 : 





QObject 
| 
+- QLayout 
| 
+- QBoxLayout 


| 
+- QHBoxLayout 


在 创建 QHBoxLayout 布 局 时 用 到 的 对 齐 方式 参数 如 表 6-2 所 示 。 


表 6-2 


本 例文 件 名 为 PyQt5/Chapter06/qt06_hboxLayout.py， 其 核心 代码 如 





ie 
from PyQt5.QtCore import Qt 
class Winform(QWidget): 
def __init__(self,parent=None): 
super(Winform, self). init__ (parent) 
self.setWindowTitle(" 水 平 布 局 管理 例子 ") 
# 水 平 布 局 按照 从 左 到 右 的 顺序 添加 按钮 控件 
hlayout=QHBoxLayout() 
hlayout.addWidget( QPushButton(str(1))) 
hlayout.addWidget( QPushButton(str(2))) 
hlayout.addWidget( QPushButton(str(3))) 
hlayout.addWidget( QPushButton(str(4))) 
hlayout.addWidget( QPushButton(str(5))) 
self.setLayout(hlayout) 
运行 脚本 ， 显 示 效 果 如 图 6-5 所 示 。 





图 6-5 








在 茶 些 情况 下 ， 需 要 将 布局 中 的 茶 些 控件 居 上 、 拓 下 显示 ， 那 么 可 
以 通过 对 章 方式 参数 Qt.Alignment 来 设置 。 本 例文 件 名 为 
PyQt5/Chapter06/qt06_boxLayout02.py， 演 示 使 用 Qt.AlignLeft、 
Qt.AlignLeft、Qt.AlignBottom 参 数 来 设置 控件 的 布局 。 其 核心 代码 如 
下 : 





# 水 平 布 局 按照 从 左 到 右 的 顺序 添加 按钮 控件 
hlayout=QHBoxLayout() 
#7K-P 7c. EAEC 
hlayout.addWidget( QPushButton(str(1)) ,0 ,| Qt.AlignTop) 
hlayout.addWidget( QPushButton(str(2)) ,0 ,Qt.AlignLeft | 
Qt.AlignTop) 
hlayout.addWidget( QPushButton(str(3))) 
#7K-F G7. EAE BOOST 
hlayout.addWidget( QPushButton(str(4)) ,0 ,Qt.AlignLeft | 
Qt.AlignBottom ) 
hlayout.addWidget( QPushButton(str(5)),0 ,Qt.AlignLeft | 
Qt.AlignBottom) 
运行 脚本 ， 显 示 效 果 如 图 6-6 所 示 。 








水 平 布局 管理 例子 - ORS 





图 6-6 


还 可 以 使 用 ”setSpacing(int) 设 置 各 控件 之 间 的 间距 。 本 例文 件 名 为 
PyQt5/Chapter06/qt06_boxLayout01.py， 使 用 setSpacing(0) 将 各 控件 之 间 
的 间距 设置 为 0。 其 核心 代码 如 下 : 

# 初始 化 水 平 布局 
hlayout=QHBoxLayout() 
hlayout.addWidget( QPushButton(str(1)) ) 
hlayout.addWidget( QPushButton(str(2)) ) 
hlayout.addWidget( QPushButton(str(3))) 
hlayout.addWidget( QPushButton(str(4)) ) 
hlayout.addWidget( QPushButton(str(5))) 
# 设置 控件 间距 
hlayout.setSpacing( 0 ) 

运行 脚本 ， 显 示 效 果 如 图 6-7 所 示 。 


水 平 布局 管理 例子 - OES 
1 2 3 一 5 
图 6-7 





采用 QVBoxLayout 类 ， 按 照 从 上 到 下 的 顺序 添加 控件 。 本 例文 件 
名 为 PyQt5/Chapter06/qt06_vboxLayout.py， 其 核心 代码 如 下 : 
class Winform(QWidget): 


def _init (self,parent=None): 


super(Winform, self). init (parent) 
self.setWindowTitle(" 垂 直 布 局 管理 例子 ") 
# 垂直 布局 按照 从 上 到 下 的 顺序 添加 按钮 控件 
vlayout=QVBoxLayout() 
vlayout.addWidget( QPushButton(str(1))) 
vlayout.addWidget( QPushButton(str(2))) 
vlayout.addWidget( QPushButton(str(3))) 
vlayout.addWidget( QPushButton(str(4))) 
vlayout.addWidget( QPushButton(str(5))) 
self.setLayout(vlayout) 

运行 脚本 ， 显 示 效 果 如 图 6-8 所 示 。 


im | x 


图 6-8 


6.4.3 addStretch() PK ŽU 


在 布局 时 要 用 4l|addStretch() cf 数 。 设 置 stretch 伸 缩 量 后 ， 按 比例 分 
配 剩余 空间 。addStretch0 函 数 的 具体 使 用 请 参考 表 6-3。 


表 6-3 


QBoxLayout.addStretch ( int stretch = 0 ) addStretch() 函 数 在 布局 管理 器 中 增加 一 个 可 伸缩 的 控件 CQSpaceltem), 0 


为 最 小 值 ， 并 且 将 stretch 作为 伸缩 量 添 加 到 布局 末尾 
stretch 参数 表示 均 分 的 比例 ， 默 认 值 为 0 


本 例文 件 名 为 PyQt5/Chapter06/qt06_layoutAddStretch01.py， 一 个 布 
局 管理 器 中 有 三 个 按钮 控件 ， 要 求 界 面 不 随 着 父 控件 的 伸 盎 而 改变 。 其 
完整 代码 如 下 : 








from PyQt5.0tWidgets import QApplication ,QWidget, QVBoxLayout ， 
QHBoxLayout ,QPushButton 


import sys 


class WindowDemo (QWidget) : 
Ge Anri NSE 


superi). init 10) 


btnl QPushButton (self) 
btn2 = QPushButton (self) 


btn3 = QPushButton (self) 
btnl.setText('button 1') 
btn2.setText ("button 2") 
btn3.setText ('button 3') 


hbox = QHBoxLayout () 

# 设置 伸缩 量 为 1 
hbox.addStretch (1) 
hbox.addWidget( btnl ) 
# 设置 伸缩 量 为 1 
hbox.addStretch (1) 
hbox.addWidget( btn2 ) 
# 设置 伸缩 量 为 1 
hbox.addStretch (1) 
hbox.addWidget( btn3 ) 
# 设置 伸缩 量 为 1 
hbox.addStretch (1) 


self.setLayout (hbox) 
self.setWindowTitle("addStretch 例子 ") 


if name ==" main ": 
app = QApplication(sys.argv) 


win WindowDemo () 
win. show () 


Sysmex nt (dppaexee OD 


运行 脚本 ， 显 示 效 果 如 图 6-9 所 示 。 伸 缩 后 的 效果 如 图 6-10 所 示 。 





= 


| button 1 | i button 2 | | button 3 | 








图 6-9 





in x 


图 6-10 


从 上 面 的 代码 可 以 看 出 ， 四 个 addStretch() 函 数 用 于 在 按钮 间 设 置 伸 
缩 量 ， 伸 缩 量 的 比例 为 1:1:1:1， 意 思 是 将 按钮 以 外 的 空白 地 方 等 分 为 4 
份 ， 并 按照 所 设置 的 顺序 放 入 按钮 的 布局 管理 器 中 。 这 样 在 每 一 个 控件 
之 间 就 都 添加 了 伸缩 量 ， 所 有 控件 之 间 的 间距 都 会 相同 。 

本 例文 件 名 为 PyQt5/Chapter06/qt06_layoutAddStretch02.py， 演 示 在 
布局 中 使 用 addStretch() 函 数 ， 在 第 一 个 控件 之 前 添加 伸缩 控件 ， 这 样 所 
有 的 控件 就 都 会 居 右 显示 。 其 核心 代码 如 下 : 

hlayout=QHBoxLayout() 

# 添加 拉 伸 控件 

hlayout.addStretch(0) 

hlayout.addWidget( QPushButton(str(1)) ) 

hlayout.addWidget( QPushButton(str(2)) ) 

hlayout.addWidget( QPushButton(str(3)) ) 

hlayout.addWidget( QPushButton(str(4)) ) 

hlayout.addWidget( QPushButton(str(5)) ) 
运行 脚本 ， 显 示 效 末 如 图 6-11 所 示 。 
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图 6-11 


本 例文 件 名 为 PyQt5/Chapter06/qt06_layoutAddStretch03.py， 演 示 在 
布局 中 使 用 addStretch0 函 数 ， 在 最 后 一 个 控件 之 后 添加 伸缩 控件 ， 这 样 
所 有 的 控件 就 都 会 居 左 显示 。 其 核心 代码 如 下 : 

hlayout=QHBoxLayout() 


hlayout.addWidget( QPushButton(str(1)) ) 
hlayout.addWidget( QPushButton(str(2)) ) 
hlayout.addWidget( QPushButton(str(3))) 
hlayout.addWidget( QPushButton(str(4)) ) 
hlayout.addWidget( QPushButton(str(5))) 
# 添加 伸缩 控件 

hlayout.addStretch(0) 

运行 脚本 ， 显 示 效 果 如 图 6-12 所 示 。 
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图 6-12 


6.5 QGridLayout (网 格 布 局 ) 


QGridLayout《〈 网 格 布局 ) 是 将 窗口 分 隔 成 行 和 列 的 网 格 来 进行 排 
列 。 通 常 可 以 使 用 函数 addWidget0 将 被 管理 的 控件 《Widget) 添加 到 窗 
口中 ， 或 者 使 用 addLayout0) 函 数 将 布局 (Layout) 添加 到 窗口 中 。 也 可 
以 通过 addWidget() 函 数 对 所 添加 的 控件 设置 行 数 和 列 数 的 跨越 ， 最 后 实 
现 网 格 占据 多 个 窗 格 。 

QGridLayout 类 中 的 第 用 方法 如 表 6-4 所 示 。 





表 6-4 


addWidget ( QWidget widget, int row, int col, | 给 网 格 布局 添加 控件 , 设置 指定 的 行 和 列 。 起 始 位 置 C(top-left position) 


int alignment = 0 ) 的 默认 值 是 (0,0) 。 

e widget: 所 添加 的 控件 

erow: 控件 的 行 数 ， 默 认 从 0 开始 

e column: 控件 的 列 数 ， 默 认 从 0 开始 
e alignment: 对 齐 方式 
addWidget(QWidget widget, int fromRow, int | 所 添加 的 控件 跨越 很 多 行 或 者 列 时 ， 使 用 这 个 函数 。 
fromColumn, int rowSpan, int columnSpan, | © widget: 所 添加 的 控件 

Qt.Alignment alignment = 0) e fromRow: 控件 的 起 始 行 数 

e fromColumn: 控件 的 起 始 列 数 

e rowSpan: 控件 跨越 的 行 数 

e columnSpan: 控件 跨越 的 列 数 

e alignment: 对 齐 方式 

setSpacing ( int spacing ) 设置 控件 在 水 平和 垂直 方向 的 间隔 


QGridLayout 类 的 继承 结构 如 下 : 











QObject 
| 
+- QLayout 
| 
+- QGridLayout 





本 例文 件 名 为 PyQt5/Chapter06/qt06_vboxLayout01.py。 其 完整 代码 
如 下 : 


import sys 
from PyQt5.QtWidgets import QApplication,QWidget, QGridLayout, 
QPushButton 


class Winform(QWidget) : 
def init  (self£,parent=None) : 


super (Winform,self). init (parent) 


self.initUI () 


def initUI (self): 
# 1 
grid = QGridLayout () 
self.setLayout (grid) 


# 2 
hanes, = [SCILST NBCK WE Neloset. 

Mag fad KEI WE Tae Ae 

ie layer noes, PA 

R eae Wes hae ee 

LOR. ee '=', Bers 
# 3 
positions = [(i,j) for i in range(5) for j in range(4) ] 
# 4 
for position, name in zip(positions, names): 

if name == '';: 
continue 


button = QPushButton (name) 
grid.addWidget (button, *position) 


self.move (300, 150) 
self.setWwindowTitle(' 网 格 布局 管理 例子 ') 


if name ==" main ": 
app = QApplication(sys.argv) 
form = Winform() 

form. show () 


sys.exit(app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 6-13 所 示 。 
第 1 组 代码 : 创建 QGridLayout 的 实例 ， 并 设置 为 窗口 的 布局 。 
第 2 组 代码 : 创建 按钮 的 标签 列表 。 


第 3 组 代码 : 在 网 格 中 创建 一 个 位 置 列表 。 
第 4 组 代码 : 创建 按钮 ， 并 通过 addWidget(0) 方 法 添加 到 布局 中 。 





























本 例文 件 名 为 PyQt5/Chapter06/qt06_vboxLayout02.py， 其 完整 代码 
如 下 : 


grid.addWidget (reviewEdit, 3, 1, 5, 1) 
self.setLayout (grid) 


self.setGeometry (300, 300, 350, 300) 
self.setWindowTitle(' 故 障 申 告 ') 


nse mm 
app = QApplication(sys.argv) 
form = Winform() 
form. show () 


sys.exit(app.exec_ ()) 


运行 脚本 ， 显 示 效 果 如 图 6-14 所 示 。 














图 6-14 


代码 分 析 : 


grid.addWidget(titleLabel,1,0) 

把 titleLabel 放 在 QGridLayout 布 局 的 第 1 行 第 0 列 。 
grid.addWidget(titleEdit, 1,1) 

把 titleEdit 放 在 QGridLayout 布 局 的 第 1 行 第 1 列 。 
grid.addWidget(contentLabel,3,0) 

把 contentLabel 放 在 QGridLayout 布 局 的 第 3 行 第 0 列 。 
grid.addWidget(contentEdit,3,1,5,1) 

把 contentEdit 放 在 QGridLayout 布 局 的 第 3 行 第 1 列 ， 跨 越 5 行 和 1 列 。 


6.6 QFormLayout (表单 布局 ) 





QFormLayout 是 label-field 式 的 表单 布局 ， 顾 名 思 义 ， 就 是 实现 表单 
方式 的 布局 。 表 单 是 提示 用 户 进行 交互 的 一 种 模式 ， 其 主要 由 两 列 组 
成 ， 第 一 列 用 于 显示 信息 ， 给 用 户 提示 ， 一 般 叫 作 label 域 ， 第 二 列 需 
要 用 户 进行 选择 或 输入 ， 一 般 叫 作 field 域 。label 与 field 的 关系 就 是 label 
关联 field。 

QFormLayout 类 的 继承 结构 如 下 : 





QObject 
| 
t- QLayout 
| 
+- QFormLayout 


本 例文 件 名 为 PyQt5/Chapter06/qt06_formLayout.py， 其 核心 代码 如 
下 : 
class Winform(QWidget): 

def _init (self,parent=None): 
super(Winform,self)._init__ (parent) 
self.setWindowTitle(" 2. 7fi Ja E FE Wl F-") 
self.resize(400, 100) 
fromlayout=QFormLayout() 
labl1=QLabel(" 标 签 1"); 
lineEdit1=QLineEdit(); 
labl2=QLabel(" 标 签 2"); 
lineEdit2=QLineEdit(); 


labl3=QLabel(" 标 签 3"); 
lineEdit3=QLineEdit(); 
fromlayout.addRow(labl1,lineEdit1); 
fromlayout.addRow(labl2,lineEdit2); 
fromlayout.addRow(labl3,lineEdit3); 
self.setLayout(fromlayout) 

ISAT IAS, LAN CR UN AIG-15 TAN 








图 6-15 





6.7 RET JE 


在 窗口 中 进行 单一 的 布局 比较 简单 ， 但 是 如 果 要 进行 比较 复杂 的 布 
局 ， 一 般 束 会 涉及 布局 的 藤 套 了 。 








本 例文 件 名 为 PyQt5/Chapter06/qt06_nestLayout01.py。 其 完整 代码 
如 下 : 


import sys 
from PyQt5.QtWidgets import QApplication ,QWidget , QHBoxLayout, 
QVBoxLayout, QGridLayout , QFormLayout, QPushButton 


class MyWindow( QWidget): 


def _ init (self): 
super(). init  () 
self.setWindowTitle('kE#A Fl") 


# 全 局 布局 (2 种 ) : KF 

wlayout = QHBoxLayout () 

# 局 部 布局 (4 种 ) : KL EH, MK RŽ 
hlayout = QHBoxLayout () 

vlayout = QVBoxLayout () 

glayout = QGridLayout () 

formlayout = QFormLayout () 


# 为 局 部 布局 添加 控件 (例如; 按钮 ) 
hlayout.addWidget ( QPushButton(str(1) ) 
hlayout.addWidget( QPushButton(str(2) ) 
vlayout.addWidget ( QPushButton(str (3) ) 
vlayout.addWidget ( QPushButton (str (4) ) 
glayout.addWidget ( QPushButton(str(5)) , 0, 0 ) 
glayout.addWidget( QPushButton(str(6)) , 0, 1 ) 
glayout.addWidget ( QPushButton(str(7)) , 1, 0) 
glayout.addWidget( QPushButton(str(8)) , 1, 1) 
formlayout.addWidget ( QPushButton(str(9)) ) 
formlayout.addWidget( QPushButton(str(10)) ) 
formlayout.addWidget ( QPushButton(str(11)) ) 
formlayout.addWidget( QPushButton(str(12)) ) 


Ser het, eer Ne 





运行 脚本 ， 显 示 效 果 如 图 6-16 所 示 。 











图 6-16 


代码 分 析 : 

(1) 全 局 布局 

全 局 布局 采用 的 是 水 平 布局 。 

wlayout=QHBoxLayout() 

(2) 局 部 布局 

局 部 布局 采用 的 分 别 是 水 平 布局 、 垂 直 布 局 、 网 格 布局 和 表单 布 


hlayout=QHBoxLayout() 
vlayout=QVBoxLayout() 
glayout=QGridLayout() 
formlayout=QFormLayout() 

首先 ， 准 备 4 个 QWidget 控 件 : hwg、vwg、gwg 和 formlayout。 
hwg=QWidget() 
vwg=QWidget() 
gwg=QWidget() 
fwg=QWidget() 

然后 ， 使 用 4 个 QWidget 控 件 分 别 设置 局 部 布局 。 
hwg.setLayout(hlayout) 





vwg.setLayout(vlayout) 


gwg.setLayout(glayout) 
fwg.setLayout(formlayout) 
接 下 来 ， 将 4 个 QWidget 控件 添加 到 全 局 变量 中 。 
wlayout.addWidget(hwg) 
wlayout.addWidget(vwg) 
wlayout.addWidget(gwg) 


wlayout.addWidget(fwg) 
最 后 ， 把 全 局 布局 应 用 到 窗口 本 里 。 
self.setLayout(wlayout) 


分 析 结 果 如 图 6-17 所 示 。 





在 上 一 节 中 ， 我 们 讨论 了 两 层 圣 套 布局 的 情况 。 这 样 的 布局 有 一 个 
缺点 : 4 ”种 局 部 布局 需要 4 个 空白 控件 ， 假 如 有 10 种 局 部 布局 ， 就 需要 
10 个 空白 控件 。 怎 么 解雇 这 个 问题 呢 ? 

不 管 有 多 少 种 局 部 布局 ， 只 需要 一 个 空白 控件 ， 然 后 在 这 个 空 日 控 
件 中 进行 多 种 布局 ， 就 可 以 实现 相同 的 效果 。 

本 例文 件 名 为 PyQt5/Chapter06/qt06_nestLayout02.py， 其 完整 代码 














如 下 : 


from PyOQt5.QtWidgets import * 


import sys 
class MyWindow (QWidget) : 


def init (self): 
super(). init. () 
self.setWindowTitle('hkEAA RS ') 
self.resize(700, 200) 


# 全 局 控件 (注意 参数 self ) ， 用 于 “承载 ”全 局 布局 
wwg = QWidget (self) 


# 全 局 布局 ( 注意 参数 wwg ) 

wl = QHBoxLayout (wwg) 
hlayout = QHBoxLayout () 
vlayout = QVBoxLayout () 
glayout = QGridLayout () 
formlayout = QFormLayout () 


# 为 局 部 布局 添加 控件 (例如: 按钮 ) 

hlayout.addWidget( QPushButton (str (1)) 
hlayout.addWidget( QPushButton (str (2)) 
vlayout.addWidget( QPushButton (str (3)) 
vlayout.addWidget ( QPushButton (str (4)) 
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glayout.addWidget ( 
glayout.addWidget ( 
glayout.addWidget ( 
glayout.addWidget ( 


QPushButton (str (5) ) 
QPushButton (str (6) ) 
QOPushButton (str (7) ) 
QPushButton (str (8) ) 


r 


formlayout.addWidget ( QPushButton(str(9)) ) 
formlayout.addWidget( QPushButton(str(10)) ) 
formlayout.addWidget( QPushButton(str(11)) ) 
formlayout.addWidget( QPushButton(str(12)) ) 


# 这 里 在 局 部 布局 中 添加 控件 ， 然 后 将 其 添加 到 全 局 布局 中 
wl.addLayout (hlayout) 


H 


wl.addLayout (vlayout) 


an 


wl.addLayout (glayout) 


p 


wl.addLayout (formlayout) 


WE name ==" main 





app = QApplication(sys.argv) 
win = MyWindow () 
win. show () 


sys.exit(app.exec ()) 


运行 脚本 ， 显 示 效 果 同 图 6-16。 
代码 分 析 : 
(1) 先 准备 一 个 全 局 控件 ， 用 于 添加 全 局 布局 。 


# 全 局 控件 (注意 参数 sed) ， 用 于 添加 全 局 布局 


wwg=QWidget(self) 

(2) 定义 全 局 布局 。 
wl=QHBoxLayout(wwg) 

(3) 定义 4 种 局 部 布局 。 
hlayout=QHBoxLayout() 
vlayout=QVBoxLayout() 
glayout=QGridLayout() 
formlayout=QFormLayout() 

C4) 在 局 部 布局 中 放置 一 些 按钮 控件 。 
hlayout.addWidget( QPushButton(str(1)) ) 
hlayout.addWidget( QPushButton(str(2)) ) 
vlayout.addWidget( QPushButton(str(3)) ) 
vlayout.addWidget( QPushButton(str(4)) ) 
glayout.addWidget( QPushButton(str(5)) ,0,0 ) 
glayout.addWidget( QPushButton(str(6)) ,0,1 ) 
glayout.addWidget( QPushButton(str(7)) ,1,0) 





glayout.addWidget( QPushButton(str(8)) ,1,1) 

formlayout.addWidget( QPushButton(str(9)) ) 

formlayout.addWidget( QPushButton(str(10)) ) 

formlayout.addWidget( QPushButton(str(11)) ) 

formlayout.addWidget( QPushButton(str(12)) ) 
(5) 把 4 种 局 部 布局 添加 到 全 局 布局 中 

wl.addLayout(hlayout) 

wl.addLayout(vlayout) 

wl.addLayout(glayout) 

wl.addLayout(formlayout) 


6.8 QSplitter 


除了 上 面 介绍 的 Layout 布局 管理 ，PyQt 还 提供 了 一 个 特殊 的 布局 
管理 器 QSplitter， 它 可 以 动态 地 拖 动 子 控件 之 间 的 边界 ， 算 是 一 个 动态 
的 布局 管理 器 。QSplitter 允许 用 户 通 过 拖 动 子 控件 的 边界 来 控制 子 控件 
的 大 小 ， 并 提供 了 一 个 处 理 拖 电子 控件 的 控制 器 。 

在 QSplitter 对 象 中 各 子 控 件 默 认 是 横 回 布局 的 ， 可 以 使 用 Qt.Vertical 
进行 垂直 布局 。QSplitter 类 中 的 利用 方法 如 表 6-5 所 示 。 











将 小 控件 添加 到 QSplitter 管理 器 的 布局 中 
indexOf() 返回 小 控件 在 QSplitter 管理 器 中 的 索引 
根据 指定 的 索引 将 一 个 控件 插入 到 QSplitter 管理 器 中 


setOrientation() 设置 布局 方向 : 
e Qt.Horizontal， 水 平方 向 
| 。 QtLVertical， 重 直方 问 
设置 控件 的 初始 化 大 小 
返回 小 控件 在 QSplitter 管理 器 中 的 数量 
本 例文 件 名 为 PyQt5/Chapter06/qt06_QSplitter.py， 演 示 在 PyQt 5 的 


窗口 中 使 用 QSplitter 控 件 。 其 完整 代码 如 下 : 





= 





import sys 


from PyOt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QtWidgets import * 


class SplitterExample (QWidget): 


def 


def 


-iare (self): 
super (SplitterExample, self). init () 
self.initUI () 


initUI (self): 
hbox = QHBoxLayout (self) 
self.setWindowTitle('QSplitter 例子 ') 


self.setGeometry(300, 300, 300, 200) 
topleft = QFrame() 

topleft.setFrameShape (QFrame.StyledPanel) 
bottom = QFrame () 

bottom.setFrameShape (QFrame.StyledPanel) 
splitterl = QSplitter(Qt.Horizontal) 
textedit = QTextEdit () 
splitterl.addWidget (topleft) 
splitterl.addWidget (textedit) 
splitterl.setSizes([100,200]) 

splitter2 = QSplitter(Qt.Vertical) 
splitter2.addWidget (splitter1) 
splitter2.addWidget (bottom) 
hbox.addWidget (splitter2) 

self.setLayout (hbox) 


we eS Sveti Ne 


app 


= QApplication(sys.argv) 


demo = SplitterExample () 


demo. show () 


sys. 


exit (app.exec_()) 


运行 脚本 ， 显 示 效 果 如 图 6-18 所 示 。 
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图 6-18 


代码 分 析 : 
在 这 个 例子 中 ， 显 示 了 使 用 两 个 QSplitter 组 织 的 两 个 QFrame 控 件 。 
其 中 第 一 个 QSplitter 对 象 包含 了 一 个 QFrame 对 象 和 QTextEdit 对 象 ， 并 按 
照 水 平方 向 进行 布局 。 
topleft=QFrame() 
topleft.setFrameShape(QFrame.StyledPanel) 
splitter1=QSplitter(Qt.Horizontal) 
textedit=QTextEdit() 
splitter1.addWidget(topleft) 
splitter1 .addWidget(textedit) 
第 二 个 QSplitter 对 象 添 加 了 第 一 个 QSplitter 对 象 和 另 一 个 QFrame 对 
象 ， 并 按照 垂直 方向 进行 布局 。 
bottom=QFrame() 
splitter2=QSplitter(Qt. Vertical) 
splitter2.addWidget(splitter1) 
splitter2.addWidget(bottom) 
hbox.addWidget(splitter2) 








self.setLayout(hbox) 


#7 PyQt5fa5 5 


7.1 信号 与 槽 介绍 


言 号 (Signal) Als (Slot) 是 Qt 中 的 核心 机 制 ， 也 是 在 PyQt 编 程 
中 对 象 之 间 进 行 通信 的 机 制 。 在 Qt 中 ， 每 一 个 QObject 对 象 和 PyQt 中 所 
有 继承 和 目 QWidget 的 控件 〈 这 些 都 是 QObject 的 子 对 象 ) 都 文 持 信和 号 与 
槽 机 制 。 当 信号 发 射 时 ， 连 接 的 模 函 数 将 会 自动 执行 。 在 PyQt 5 中 信和 号 
与 槽 通过 object.signal.connect0 方 法 连接 。 

PyQt 的 窗口 控件 类 中 有 很 多 内 置信 号 ， 开 发 者 也 可 以 添加 自 定 义 信 
So fas SAA UP PER 

e — ME Ss A) WERE ME 

e 一 个 信号 可 以 连接 另 一 个 信号。 

o 信号 参数 可 以 是 任何 Python 类 型 。 

o 一 个 槽 可 以 监听 多 个 信号。 

e 信号 与 槽 的 连接 方式 可 以 是 同步 连接 ， 也 可 以 是 民 步 连接 。 

e 信号 与 槽 的 连接 可 能 会 跨 线 程 。 

o 信号 可 能 会 断 开 。 

在 GUI 编 程 中 ， 当 改变 一 个 控件 的 状态 时 如 单 击 了 按钮 )》， 通 常 
需要 通知 另 一 个 控件 ， 也 就 是 实现 了 对 象 之 间 的 通信 。 在 早期 的 GUI 编 
程 中 使 用 的 是 回调 机 制 ， 在 Qt 中 则 使 用 一 种 新 机 制 ao th. CESK 
写 一 个 类 时 ， 要 先 定义 该 类 的 信号 与 槽 ， 在 类 中 信和 号 与 槽 进行 连接 ， 实 












































现 对 象 之 间 的 数据 传输 。 信 号 与 权 机 制 示意 图 如 图 7-1 所 示 。 
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图 7-1 


当 事 件 或 者 状态 发 生 改 变 时 ， 就 会 发 出 信号 。 同 时 ， 信 号 会 触及 所 
有 与 这 个 事件 (信号 ) 相关 的 函数 〈 模 ) 。 信 号 与 模 可 以 是 多 对 多 的 关 
系 。 一 个 信号 可 以 连接 多 个 槽 ， 一 个 槽 也 可 以 监听 多 个 信和 号 

关于 PyQt API 中 信号 与 槽 的 更 详细 解释 ， 可 以 参考 官方 网 站 : 
http://pygt.sourceforge.net/Docs/PyQt5/signals_slots.html? 
highlight=pyqtsignal#PyQt5.QtCore.pyqtSignal. 


7.1.1 © XEF 


PyQt 的 内 置信 号 是 自动 定义 的 。 使 用 PyQt5.QtCore.pyqtSignal() eA 
数 可 以 为 QObject 创建 一 个 信号 ， 使 用 pyqtSingnalO 函 数 可 以 把 信和 号 定 
义 为 类 的 属性 。pygqtSignal0) 函 数 信息 如 图 7-2 所 示 。 


PyQt5. QtCore. pyqtSignal(typesl, namel, revision=0l, arguments=[]]]]) 
Create one or more overloaded unbound signals as a class attribute. 





Parameters: 。 types — the types that define the C++ signature of the signal. Each type may be a Python type object or 
a string that is the name of a C++ type. Alternatively each may be a sequence of type arguments. In 
this case each sequence defines the signature of a different signal overload. The first overload will be 
the default. 

e name — the name of the signal. If it is omitted then the name of the class attribute is used. This may 
only be given as a keyword argument. 

e revision — the revision of the signal that is exported to QML. This may only be given as a keyword 
argument. 

e arguments — the sequence of the names of the signal’ s arguments that is exported to QML. This may 
only be given as a keyword argument. 

Return an unbound signal 


type: 





图 7-2 


1. 为 QObject 对 象 创 建 信和 号 

使 用 pyqtSignalO0 函 数 创建 一 个 或 多 个 重 载 的 未 绑 定 的 信号 作为 类 的 
属性 ， 信 号 只 能 在 QObject 的 子 类 中 定义 ， 如 图 7-3 所 示 。 

言 号 必须 在 类 创建 时 定义 ， 不 能 在 类 创建 后 作为 类 的 属性 动态 添加 
进来 。types 参 数 表 示 定 义 信 号 时 参数 的 类 型 ，name 参 数 表 示 信 和 号 名 
字 ， 该 项 缺 省 时 使 用 类 的 属性 名 字 。 























class Foo(Q0bject): 


# Thye =} 


z9 ry , i : 
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valueChanged = pyqtSignal([dict], [list]) 
图 7-3 


使 用 pyqtSignalO 函 数 创 建 信 号 时 ， 信 和 号 可 以 传递 多 个 参数 ， 并 指定 
言 号 传递 参数 的 类 型 ， 参 数 类 型 是 标准 的 Python 数据 类 型 “字符 串 、 日 
期 、 布 尔 类 型 、 数 字 、 列 表 、 元 组 和 字典 ) 。 

2. 为 控件 创建 信号 

from PyQt5.QtCore import pydtSignal 
from PyQt5.QtWidgets import QMainWindow 
class WinForm(QMainWindow): 








btnClickedSignal=pyqtSignal() 
上 面 代 码 为 自 定 义 控 件 WinForm 创 建 了 一 个 binnClickedSignal 信 和 号。 


7.1.2 操作 信号 


使 用 connect() 函 数 可 以 把 信号 绑 定 到 槽 函数 上 。connect(0) 函 数 信息 
如 图 7-4 所 示 。 


connect(s/otl, type=PyQt5.Qtc ore.Qt.AutoConnection|, no_receiver_check=False]]) 
Connect a signal to a slot. An exception will be raised if the connection failed. 


Parameters: œ slot- the slot to connect to, either a Python callable or another bound signal. 
© type - the type of the connection to make. 
e no_receiver_check — suppress the check that the underlying C++ receiver instance still exists and 
deliver the signal anyway. 











图 7-4 


使 用 disconnectO 函 数 可 以 解除 信号 与 槽 函数 的 绑 定 。disconnect() 函 
数 信 息 如 图 7-5 所 示 。 





| disconnect([s/ot]) 
| 
Disconnect one or more slots from a signal. An exception will be raised if the slot is not connected to the signal or if the 


signal has no connections at all. 


| Parameters: slot- the optional slot to disconnect from, either a Python callable or another bound signal. If it is 
| omitted then all slots connected to the signal are disconnected. 





图 7-5 


使 用 emit0 函 数 可 以 友 射 信和 写 。emit0 函 数 信息 如 图 7-6 所 示 。 





emit(*args) 
Emit a signal. 


Parameters: args -the optional sequence of arguments to pass to any connected slots. 


图 7-6 


7.1.3 信号 与 模 的 入 门 应 








信号 与 槽 有 三 种 使 用 方法 ， 第 一 种 是 内 置信 号 与 槽 的 使 用 ， 第 二 种 
是 目 定 义 信 号 与 槽 的 使 用 ， 第 三 种 是 装饰 右 的 信和 号 2 由 于 第 
三 种 方法 本 质 上 是 第 一 种 方法 的 衍生 ， 因 此 这 里 先 介 
门 案例 。 对 于 第 三 种 方法 ， 会 在 7.3.3 节 “装饰 器 信号 与 槽 ”中介 
1. 内 置信 号 与 槽 的 使 用 
所 谓 内 置信 号 与 槽 的 使 用 ， 是 指 在 发 射 信 号 时 ， 使 用 窗口 控件 的 函 
数 ， 而 不 是 目 定义 的 函数 。 在 信号 与 槽 中 ， 可 以 通过 
QObject.signal.connect 将 一 个 QObject 的 信号 连接 到 另 一 个 QObject 的 
模 函 数 。 本 例文 件 名 为 PyQt5/Chapter07/qt07_winSignalSlot01.py， 其 完 
整 代码 如 下 : 
from PyQt5.QtWidgets import QPushButton ,QApplication,QWidget 
from PyQt5.QtWidgets import QMessageBox 




















import sys 
app=QApplication([]) 
widget=QWidget() 
def showMsg(): 
QMessageBox.information(widget," 信 息 提 示 框 ","ok， 弹 出 测试 
aa") 
btn=QPushButton( "测试 点 击 按钮 ,widget) 
btn.clicked.connect(showMsg) 
widget.show() 
sys.exit(app.exec_()) 
运行 脚本 ， 显 示 效 果 如 图 7-7 和 图 7-8 所 示 。 
这 个 例子 将 一 个 按钮 对 象 的 内 置 clicked 信号 连接 到 自 定义 的 槽 函 
数 showMsg0， 也 可 以 说 showMsg0 函 数 啊 应 了 一 个 按钮 单 击 事件 。 单 
击 “ 测 试点 击 按钮 ”按钮 ， 就 会 弹出 一 个 信息 提示 框 。 








ri) ok ,弹出 测试 信息 











2. 自 定义 信号 与 横 的 使 用 

同样 ， 所 谓 自 定 义 信号 与 槽 的 使 用 ， 是 指 在 发 射 信号 时 ， 不 使 用 窗 
口 控件 的 函数 ， 而 是 使 用 目 定 义 的 函数 “简单 地 说 ， 就 是 使 用 
pyqtSignal 类 实例 发 射 信号 ) 。 之 所 以 要 使 用 自 定 义 信 号 与 槽 ， 是 因为 
通过 内 置 函数 发 射 信号 有 自身 的 缺陷 。 首 先 ， 内 置 函数 只 包含 一 些 常 用 
的 信号 ， 有 些 信号 的 发 射 找 不 到 对 应 的 内 置 函 数 ， 其 次 ， 只 有 在 特定 情 
况 下 《〈 如 按钮 的 点 击 事件 ) 才能 发 射 这 种 信和 号; 最 后 ， 内 置 函 数 传递 的 
参数 是 特定 的 ， 不 可 以 自 定 义 。 使 用 自 定 义 的 信号 函数 则 没有 这 些 缺 
陷 。 

在 PyQt5 编 程 中 ， 目 定义 信号 与 槽 的 适用 范围 很 灵活 ， 比 如 因为 业 
务 需求 ， 在 程序 中 的 某 个 地 方 需要 发 射 一 个 信号 ， 传 递 多 种 数据 类 型 
实际 上 就 是 传递 参数 ) ， 然 后 在 槽 函数 中 接收 传递 过 来 的 数据 ， 这 样 
就 可 以 非常 灵活 地 实现 一 些 业务 逻辑 。 




















在 PyQt5 编 程 中 ， 信 和 号 与 槽 有 多 种 写法， 以 下 是 Python 风格 的 写 
法 。 本 例文 件 名 为 PyQt5/Chapter07/qt07_pysignalSlotpy， 其 完整 代码 如 
Fi 


from PyQt5.QtCore import QObject , pyqtSignal 


# 信号 对 象 
class QTypeSignal (QObject) : 
+ 定义 一 个 信号 


sendmsg = pyqtSignal( object) 


def apit (selfa 
super( OTypeSignal, self). init  () 


def run( self): 
# 发 射 信号 
self.sendmsg.emit('Hello Pyqt5') 


# WTA 
class QTypeSlot (QObject): 
def init (self): 


superi OTypesilot, sefy- init Q 


# 楷 对 象 中 的 模 函 数 
def get (self, msg): 
print ("QSlot get msg =>" + msg) 


if name == '_ main '": 
send = QTypeSignal () 
slot = QTypeSlot () 


# 1 
print ('--- 44i Rza HHE ---') 
send.sendmsg.connect( slot.get) 
send.run () 
# 2 
print ('--- 把 信号 与 槽 函数 的 连接 断 开 ---') 
send.sendmsg.disconnect( slot.get ) 
send.run() 

运行 结果 如 下 : 


--- 把 信号 绑 定 到 槽 函数 上 -- 
QSlot get msg= > Hello Pyqt5 

--- 把 信号 与 槽 函数 的 连接 断 开 -- 
言 吕 与 槽 连接 的 主要 步 又 如 下 。 
D 生成 一 个 信和 号。 
sendmsg=pyqtSignal(object) 

(2) 将 信号 与 槽 函数 绑 定 起 来 。 
send.sendmsg.connect(slot.get) 
(3) 槽 函数 接收 数据 。 

def get(self,msg): 

print("QSlot get msg= > " + msg) 

(4) 发 射 信号 的 实现 。 


self.sendmsg.emit('Hello Pyqt5') 
(5) JE SA eS APT K Breet), Pr ARE ea He Bek 

到 所 发 射 的 信号 一 一 字符 串 ' Hello Pyqt5'。 至 此 ， 数 据 传 递 成 功 ， 就 是 
这 么 简单 。 

send=QTypeSignal() 

slot=QTypeSlot() 

print('--- 把 信号 绑 定 到 槽 函数 上 ---) 

send.sendmsg.connect( slot.get) 

send.run() 

E, WAE SSR BgetQ Ne, IA BA EMR A 

所 及 射 的 信号 了 。 
print(--- 把 信号 与 槽 函数 的 连接 断 开 ---") 
send.sendmsg.disconnect( slot.get ) 
send.run() 

上 面 演 示 的 是 传递 一 个 参数 ， 如 果 要 传递 两 个 参数 ， 是 不 是 也 可 以 
使 用 上 面 的 方法 呢 ? 答案 是 可 以 的 ， 传 递 参数 的 思路 是 一 样 的 ， 但 在 细 
市 上 要 做 一 点 修改 。 

本 例文 件 名 为 PyQt5/Chapter07/qt07_pysignalSlot_2.py， 其 完整 代码 
如 下 : 





运行 结果 如 下 : 

--- 把 信号 绑 定 到 槽 函数 -- 

QSlot get msg= > 第 一 个 参数 第 二 个 参数 

--- 断 开 信号 与 模范 数 -- 

如 果 要 传递 更 多 的 参数 ， 请 参考 7.3.1 节 “高 级 自 定 义 信号 与 槽 ”。 


7.1.4 快速 进 阶 


上 面 的 内 容 只 是 教会 大 家 如 何 使 用 信和 号 与 槽 ， 但 是 仍然 有 两 个 问题 
没有 解决 : 第 一 个 是 PyQt 默 认 有 哪些 信号 与 槽 ;第 二 个 是 如 何 使 用 这 些 
信号 与 槽 。 事 实 上 这 部 分 内 容 我 们 在 “3.4.2 快速 进 阶 ”一 节 中 己 经 讲 过 ， 
读者 可 以 往 前 翻阅 相关 的 内 容 ， 在 这 里 旧事 重 提 是 为 了 保证 本 章 结 构 的 


完整 性 。 






































前 面 章节 中 介绍 信号 与 槽 有 三 种 使 用 方法 ， 这 三 种 方法 是 根据 使 用 
进行 分 类 的 。 本 布 介 绍 根据 信号 与 槽 各 目的 性 质 进 行 分 类 ， 以 便 读 者 对 
iz 





7.2.1 Boo A pee 





本 例文 件 名 为 PyQt5/Chapter07/qt07_buildInSignalSlot01， 演 示 单 击 
按钮 时 关闭 窗口 ， 使 用 内 置 的 信号 和 覃 函数 。 完 整 代码 如 下 : 
from PyQt5.QtWidgets import * 





import sys 
class Winform(QWidget): 
def __init__(self,parent=None): 
super()._ init (parent) 
self.setWindowTitle(' 内 置 的 信号 / 模 示 例 ]) 
self.resize(330,50 ) 
btn=QPushButton(' X #]' self) 


btn.clicked.connect(self.close) 





1 


_ main ': 


1 


if name == 
app=QApplication(sys.argv) 
win=Winform() 
win.show() 
sys.exit(app.exec_()) 
运行 脚本 ， 显 示 效 果 如 图 7-9 所 示 。 


在 上 面 代码 中 ， 单 击 按钮 时 触发 按钮 内 置 的 信号 (clicked) , 2h 
窗口 (QWidget) A BAER AL (self.close) 。 


7.2.2 y RE EA A ae St pa 





本 例文 件 名 为 PyQt5/Chapter07/qt07_buildInSignalSlot02.py， 演 示 单 
击 按钮 时 关闭 窗口 ， 使 用 内 置 的 信号 和 上 自 定义 的 柳 函 数 。 完 整 代码 如 
下 : 


from PyQt5.QtWidgets import * 
import sys 


class Winform(QWidget) : 
def init  (self,parent=None): 
super(). init (parent) 
self.setWindowTitle (' 内 置 的 信号 和 自 定义 槽 函数 示例 ') 
self.resize(330, 50 ) 
btn = QPushButton(' 关 闭 '， self) 


btn.clicked.connect (self.btn_close) 


def btn close(selt£) : 
+ Be BH 
self .cilose() 
if mane == l main 
app = QApplication(sys.argv) 
win = Winform() 


win.show() 


sys.exit(app.exec_()) 


运行 脚本 ， 显 示 效 果 如 图 7-10 所 示 。 








图 7-10 


在 上 面 代码 中 ， 单 击 按钮 时 触发 按钮 内 置 的 信号 (clicked) ， 绑 定 
自 定 义 的 槽 函数 Cself.btn_close) 。 


7.2.3 上 自 定 义 信 号 和 HH DR 


本 例文 件 名 为 PyQt5/Chapter07/qt07_buildInSignalSlot03.py， 演 示 单 
击 按钮 时 关闭 窗口 ， 使 用 自 定 义 的 信号 和 内 置 的 槽 函数 。 完 整 代码 如 
F: 


from PyQt5.QtWidgets import * 
from PyQt5.QtCore import pyqtSignal 


import sys 


class Winform(QWidget) : 
t 自 定义 信号 ， 不 带 参 数 
button clicked signal = pyqtSignal () 


def init  (self,parent=None) : 
Super () 5 anit (parent) 
self.setWindowTitle(' 自 定义 信号 和 内 置 楷 函 数 示例 ') 
self.resize(330, 50 ) 
btn = QPushButton(' 关 闭 '， self) 
# 连接 信号 与 楷 函 数 


btn.clicked.connect (self.btn_ clicked) 
# 接收 信号 ， 连 接 到 档 函 数 


self DUEtON clicked sional connect (self close) 


def btn clicked(self): 
# 发 送 自 定 义 信 号 ， 无 参数 


self.button clicked signal emit () 


if name == "' main _'!: 
app = QApplication(sys.argv) 
win = Winform() 
win.show() 


sys.exit(app.exec ()) 


ISAT AS, LAN COR ON AN7-11 TAN 








图 7-11 





在 上 面 代码 中 ， 单 击 按钮 时 触发 目 定 义 信和 号 
(button_clicked_signal) ， 绑 定 内 置 的 槽 函数 〈self.close) 。 


7.2.4 H 5-5 A eh 


本 例文 件 名 为 PyQt5/Chapter07/qt07_buildInSignalSlot04.py， 演 示 单 
击 按钮 时 关闭 窗口 ， 使 用 自 定 义 的 信号 与 槽 函数 。 完 整 代码 如 下 : 


from PyQt5.QtWidgets import * 
from PyQt5.QtCore import pyqtSignal 


import sys 


class Winform(QWidget) : 
# 自 定义 信号 ， 不 带 参 数 
button clicked signal = pyqtSignal () 


def init  (self,parent=None) : 
SUPE (ee Imit (parent) 
self.setWindowTitle(' 自 定义 信号 和 槽 函数 示例 ' ) 
self.resize(330, 50 ) 


def 


def 


btn = QPushButton(' 关 闭 '， self) 

# 连接 信号 与 档 函 数 
btn.clicked.connect (self.btn clicked) 
# 接收 信号 ， 连 接 到 自 定 义 的 楼 函数 


self. button clicked signal connecti(sel ft :btm close) 


bten elicked(selfi:; 
# 发 送 自 定义 信号 ， 无 参数 


self. button clicked signal.emit() 


btn close(self): 


self.close() 


gic eS = netstat 
app = QApplication(sys.argv) 
win = Winform() 
win.show() 
sys.-exit(app-sxec {)) 


运行 脚本 ， 显 示 效 果 如 图 7-12 所 示 。 


国 自 定 义 信号 和 樟 函 数 示 例 





图 7-12 





在 上 面 代码 中 ， 单 击 按钮 时 触发 自 定 义 信和 号 
(button_clicked_signal)， 绑 定 自 定义 的 槽 函数 〈self.btn_close) 。 








前 面 介绍 了 信号 与 槽 的 基础 应 用 ， 但 是 作为 PyQt 最 核心 的 内 容 ， 信 
号 与 槽 的 可 玩 性 远 远 不 止 这 些 ， 接 下 来 就 慢 慢 解读 信号 与 槽 的 高 级 玩 
es 























所 谓 高 级 目 定义 信号 与 槽 ， 指 的 是 我 们 可 以 以 自己 喜欢 的 方式 定义 
言 号 与 槽 函数 ， 并 传递 参数 。 上 自 定 义 信号 的 一 般 流程 如 下 : 
(LD) 定义 信号。 
(2) FE CNB PE BK. 
(3) Ras SH RA. 
(4) KES o 
1. 定 义 信号 
通过 类 成 员 变 量 定义 信号 对 象 。 
class MyWidget(QWidget): 
# 无 参数 的 信和 号 
Signal_NoParameters=pyqtSignal() 
# 带 一 个 参数 (整数 ) 的 信和 号 
Signal_OneParameter=pyqtSignal(int) 
# 市 一 个 参数 (整数 或 者 字符 串 ) 的 重 载 版 本 的 信和 号 
Signal_OneParameter_Overload=pyqtSignal([int],[str]) 
# 市 两 个 参数 (整数 ,字符 串 ) 的 信和 号 
Signal_TwoParameters=pyqtSignal(int,str) 

















# 
号 


带 两 个 参数 ([ 整 数 ,整数 ] 或 者 [整数 ,字符 串 ]) 的 重 载 版 本 的 信 


Signal_TwoParameters_Overload=pyqtSignal([int,int],[int,str]) 
2. 定 义 槽 函数 
定义 一 个 槽 函数 ， 它 有 多 个 不 同 的 输入 参数 。 


class MyWidget (QWidget) : 


def 


def 


setValue NoParameters (self): 
"RRR AGH Be 


pass 


setValue OneParameter (self,nIndex) : 
' 1" 带 一 个 参数 (整数 ) HA BSI 


Pass 


setValue OneParameter String(self,szīIndex): 
'' ' 带 一 个 参数 (字符 囊 ) ETE SE 


pass 


setValue TwoParameters(self,x,y): 
VA ABR (整数 ,整数 ) A Ba 5 


pass 


setValue TwoParameters String(self,x,szyY): 


VU ABR (整数 ,字符 串 ) HBA 








通过 connect 方 法 连接 信号 与 权 函 数 或 者 可 调用 对 象 。 








app = QApplication(sys.argv) 
widget = MyWidget() 
# 连接 无 参数 的 信号 


widget.Signal NoParameters.connect (self.setValue NoParameters ) 


# 连接 带 一 个 整数 参数 的 信号 


widget.Signal OneParameter.connect (self.setValue OneParameter) 


# 连接 带 一 个 整数 参数 ， 经 过 重 载 的 信号 
widget.Signal OneParameter Overload[int]. 


connect (self.setValue OneParameter) 


# 连接 带 一 个 整数 参数 ， 经 过 重 载 的 信号 
widget.Signal OneParameter Overload[str]. 


connect (self.setValue OneParameter String ) 


# 连接 一 个 信号 ， 它 有 两 个 整数 参数 


widget.Signal TwoParameters.connect (self.setValue TwoParameters ) 


# 连接 带 两 个 参数 (整数 ,整数 ) 的 重 载 版 本 的 信号 
widget.Signal TwoParameters Overload[int,int]. 


connect (self.setValue TwoParameters ) 


# 连接 带 两 个 参数 (整数 ,字符 串 ) 的 重 载 版 本 的 信号 
widget.Signal TwoParameters Overload[int,str]. 
connect (self.setValue TwoParameters String ) 


widget.show() 


4. 发 射 信号 
通过 emit 方 法 发 射 信号 。 
class MyWidget(QWidget): 
def mousePressEvent(self,event): 
# 发 射 无 参数 的 信和 号 
self.Signal_NoParameters.emit() 


# BN tis — TS BESO NaS 





self.Signal_OneParameter.emit(1) 
ERI i — TEBE BO) AY ERRARE “5 
self.Signal_OneParameter_Overload.emit(1) 
# 发 射 带 一 个 参数 (字符 串 ) 的 重 载 版 本 的 信和 号 
self.Signal_OneParameter_Overload.emit("abc") 
# 发 射 带 两 个 参数 (整数 ,字符 串 ) 的 信和 号 
self.Signal_TwoParameters.emit(1,"abc") 
# 发 射 珊 两 个 参数 (整数 ,整数 ) 的 重 载 版 本 的 信和 号 
self.Signal_TwoParameters_Overload.emit(1,2) 
BCBS is BAS SAE BL FAT AB) AY FAS TS 
self.Signal_TwoParameters_Overload.emit (1,"abc") 
5. 实 例 
本 例文 件 名 为 PyQt5/Chapter07/qt07_signalSlot02.py， 其 完整 代码 如 
Fe 


self.signal3.connect (self.signalCall3) 
self.signal4.connect (self.signalCall4) 
self.signal5.connect (self.signalCal15) 
self.signal6[int,str].connect (self.signalCall6) 
self.signal6[str].connect (self.signalCall6OverLoad) 


# 发 射 信号 

self.signall.emit () 

self.signal2.emit (1) 

self.signal3.emit (1,"text") 
self.signal4.emit([1,2,3,4]) 

self.signal5.emit ({"name":"wangwu","age":"25"}) 


self.signal6[int,str].emit(1,"text") 





self.signalé[str].emit ("text") 


def signalCalll(self): 


print ("signall emit") 


def signalCall2(self,val): 


print ("signal2 emit, value:",val) 


def signalCall3(self,val,text): 
print ("signal3 emit, value:",val,text) 


def signalCall4(self,val): 


print ("signal4 emit,value:",val) 


def signalCall5(self,val): 


print ("signal5 emit,value:",val) 


def signalCall6(self,val,text): 
print ("signal6 emit,value:",val,text) 


def signalCall6OverLoad(self,val): 


print ("signal6 overload emit,value:",val) 


if name == " main_!': 


custSignal = CustSignal () 


运行 结果 如 下 : 
signall emit 
signal2 emit,value: 1 
signal3 emit,value: 1 text 
signal4 emit,value: [1,2,3,4] 
signal5 emit,value: {name': 'wangwu','age': '25'} 
signal6 emit,value: 1 text 


signal6 overload emit,value: text 
7.3.2 定义 参考 


在 PyQt 编 程 过 程 中 ， 经 香 会 遇 到 给 槽 函数 传递 自 定 义 参 数 的 情况 ， 
比如 有 一 个 信号 与 槽 函数 的 连接 是 

button1.clicked.connect(show_page) 

我 们 知道 对 于 clicked 信 和 号 来 说 ， 它 是 没有 参数 的 ;对 于 show_page 
函数 来 说 ， 和 希望 它 可 以 接收 参数 。 和 希望 show_page 函 数 像 如 下 这 样 : 

def show_page(self,name): 
print(name," 点 击 啦 ") 

于 是 就 产生 一 个 问题 童 号 发 出 的 参数 个 数 为 0， 模 函数 接收 的 
参数 个 数 为 1， 由 于 0 < 1， 这 样 运 行 起 来 一 定 会 报错 〈 原 因 是 信号 发 出 
的 参数 个 数 一 定 要 大 于 槽 函数 接收 的 参数 个 数 ) 。 解 决 这 个 问题 束 是 本 
“SIN BLA: 目 定义 参数 的 传递 。 

本 书 提供 了 两 种 解决 方法 ， 其 中 一 种 解决 方法 是 使 用 lambda 表 达 
式 。 本 例文 件 名 为 PyQt5/Chapter07/qt07。 winSignalSlot04.py， 其 完整 代 
码 如 下 : 














from PyQt5.QtWidgets import QMainWindow, QPushButton , QWidget , 
QMessageBox, QApplication, QHBoxLayout 
import sys 


class WinForm(QMainWindow) : 
def init (self, parent=None): 
super (WinForm, self). init (parent) 
buttonl = QPushButton('Button 1') 
button2 = QPushButton('Button 2') 


buttonl.clicked.connect (lambda: self.onButtonClick (1) ) 
button2.clicked.connect (lambda: self.onButtonClick (2) ) 


layout = QHBoxLayout () 
layout .addWidget (button1) 
layout.addWidget (button2) 


main frame = QWidget () 


main frame.setLayout (layout) 


self.setCentralWidget (main frame) 


def onButtonClick(self, n): 
print('Button {0} W&F T'. format (n) ) 
QMessageBox.information(self, "信息 提示 框 "，'Button {0} 


clicked'.format (n) ) 


if name ==" main ": 
app = QApplication(sys.argv) 
form = WinForm() 
form. show () 


sys.exit(app.exec_ ()) 


运行 脚本 ， 显 示 效 果 如 图 7-13 和 图 7-14 所 示 。 


| Button 1 Button 2 








图 7-13 


(i) Button 1 clicked 





图 7-14 


代码 分 析 : 

单 击 “Button 1 按钮 ， 将 弹出 一 个 信息 提示 框 ， 提 示 信 息 为 "Button 
1 clicked”。Python 控 制 台 的 输出 信息 为 : 

Button 1 被 按 下 了 

这 里 重点 解释 onButtonClick() 函 数 是 怎样 处 理 从 两 个 按钮 传 来 的 信 
号 的 。 使 用 lambda 表 达 式 传递 按钮 数字 给 槽 函数 ， 当 然 也 可 以 传递 其 他 
任何 东西 ， 甚 至 是 按钮 控件 本 身 〈 假 设 槽 函数 打算 把 传递 信号 的 按钮 修 
改 为 不 可 用 的 话 ) 。 

另 一 种 解决 方法 是 使 用 functools 中 的 partial 函数 。 本 例文 件 名 为 








PyQt5/Chapter07/qt07_winSignalSlot05.py， 其 核心 代码 如 下 : 
button1.clicked.connect(partial(self.onButtonClick,1)) 
button2.clicked.connect(partial(self.onButtonClick,2)) 

采用 哪 种 方法 好 一 点 呢 ? 这 属于 风格 问题 ， 笔 者 比较 言 欢 使 用 
lambda 表 达 式 ， 因 为 其 条 理 清晰 ， 而 且 灵 活 。 


A 
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所 谓 奢 饰 器 信号 与 槽 ， 就 是 通过 装饰 堪 的 方法 来 定义 信号 和 模 函 
数 。 具 体 的 使 用 方法 如 下 : 
@PyQt5.QtCore.pyqtSlot( 人 参数 ) 
def on_ 发 送 者 对 象 名 称 _ 发 射 信 号 名 称 (self, 参 数 ): 
pass 
这 种 方法 有 效 的 前 提 是 下 面 的 函数 已 经 执行 : 
QMetaObject.connectSlotsByName(QObject) 
在 上 面 代码 中 , “发 送 者 对 象 名 称 ” 束 是 使 用 setObjectName 函 数 设置 
的 名 称 ， 因 此 目 定 义 模 函数 的 命名 规则 也 可 以 看 成 : on 使 用 
setObjectName 设 置 的 名 称 + 信号 名 称 。 接 下 来 看 具体 的 使 用 方法 。 
本 例文 件 名 为 PyQt5/Chapter07/qt07_connSlotsByName.py， 其 完整 
代码 如 下 : 








from PyQt5 import QtCore 
from PyQt5.QtWidgets import QApplication ,QWidget ,QHBoxLayout , 
QPushButton 


import sys 
class CustWidget( QWidget ): 


def anit) (self, sparent=None): 
super (CustWidget, self). init (parent) 


self.okButton = QPushButton("OK", self) 

# 使 用 setObjectName 设置 对 象 名 称 
self.okButton.setObjectName ("okButton") 
layout = QHBoxLayout () 

layout .addWidget (self.okButton) 
self.setLayout (layout) 
QtCore.QMetaObject.connectSlotsByName (self) 


@OtCore.pyqtSlot () 
def on _okButton clicked(self): 
print( "#7 OK #42") 


if name == "main 7; 


app = QApplication(sys.argv) 
win = CustWidget () 


win.show() 


app.exec_ () 


运行 脚本 ， 显 示 效 果 如 图 7-15 所 示 。 单 击 “OK” 按 钮 ， 控 制 台 打印 
出 预期 的 调试 信息 。 





Python 3.5.3 (v3.5.3:1880cb95a742, Jan 16 j 
Standard x 
>>> 单 击 了 OK 按钮 


单 击 了 OK 按钮 
单 击 了 OK 按钮 


单 击 了 OK 按钮 
单 击 了 OK 按钮 
单 击 了 OK 按钮 
单 击 了 OK 按钮 
单 击 了 OK 按钮 
单 击 了 OK 按 旬 











图 7-15 





有 的 读者 可 能 注意 到 ， 我 们 一 直 没 有 解释 下 面 这 行 代码 的 含义 : 
QMetaObject.connectSlotsByName(QObject) 

事实 上 ， 它 是 在 PyQRt 5 中 根据 信号 名 称 上 自动 连接 到 槽 函数 的 核心 代 
码 。 通 过 前 面 章 节 中 的 例子 可 以 知道 ， 使 用 pyuic5 命 令 生成 的 代码 中 会 
市 有 这 么 一 行 代码 ， 接 下 来 对 其 进行 解释 。 

这 行 代码 用 来 将 QObject 中 的 子孙 对 象 的 某 些 信号 按照 其 
objectName 连 接 到 相应 的 槽 函数 。 这 人 句 话 读 起 来 有 些 抛 口 ， 这 里 举 个 例 
子 进行 简单 说 明 。 以 上 面 例 子 中 的 代码 为 例 : 

假设 代码 QtCore.QMetaObject.connectSlotsByName(self) 己 经 执行 ， 
则 下 面 的 代码 : 

@QtCore.pyqtSlot() 
def on_okButton_clicked(self): 
print( " 单 击 了 OK 按钮 ") 

会 被 自动 识别 为 下 面 的 代码 〈 注 意 ， 函 数 中 去 掉 了 on， 因 为 on 会 
受到 connectSlotsByName 的 影响 ， 加 上 on 运行 时 会 出 现 问 题 ) : 


def _init (self,parent=None): 





self.okButton.clicked.connect(self.okButton_clicked) 
def okButton_clicked(self): 
print(" 单 击 了 OK 按钮 ") 
这 部 分 代码 放 在 PyQt5/Chapter07/qt07_connSlotsByName_2.py 文 件 


# -*- coding: utf-8 -*- 


【简介 ] 
信号 与 楷 的 自动 连接 例子 


from PyQt5 import QtCore 
from PyQt5.QtWidgets import QApplication ,QWidget ,QHBoxLayout , 
QPushButton 


import sys 
class CustWidget( QWidget ): 


def init (self, parent=None) : 
super (CustWidget, self). init (parent) 


self.okButton = QPushButton("OK", self) 

# 使 用 setObjectName 设置 对 象 名 称 
self.okButton.setObjectName ("okButton") 

layout = QHBoxLayout () 

layout .addWidget (self.okButton) 

self.setLayout (layout) 
QtCore.QMetaObject.connectSlotsByName (self) 
self.okButton.clicked.connect (self.okButton_ clicked) 


def okButton_clicked(self): 
print( "ET OK #4") 


if mame ==" main ": 
app = QApplication(sys.argv) 
win = CustWidget () 


win. show () 


sys.exit(app.exec ()) 
运行 上 述 代 码 ， 发 现 结果 和 图 7-15 一 样 。 
7.3.4 信号 与 模 的 此 MÆ 


有 时 候 基 于 东 些 原因 ， 想 要 临时 或 永久 断 开 某 个 信号 与 槽 的 连接 。 











ee ASH SE AE BIA BAN) AY 
本 例文 件 名 为 PyQt5/Chapter07/qt07_signalSlot03.py， 其 完整 代码 如 
下 : 


if name == ' main ': 


Signal = SignalClass() 
运行 结果 如 下 : 


Signal-1l emit 
Signal-2 emit 


Signal-1l emit 








前 面 给 出 的 是 手工 输入 代码 的 信号 与 槽 的 使 用 方法 ， 因 为 采用 这 种 
方式 介绍 时 会 更 简单 一 些 。 如 果 采 用 Qt Designer 来 介绍 这 些 内 容 ， 那 么 
任何 一 个 简单 的 功能 都 需要 使 用 xxx.ui、xxx.py、Call_xxx.py 三 个 文件 来 
实现 ， 这 样 做 内 容 会 显得 很 乱 。 

在 实战 应 用 中 ， 由 于 Qt Designer 可 以 更 好 地 实现 界面 显示 与 业务 还 
辑 的 分 离 ， 所 以 能 帮助 我 们 解决 大 量 的 代码 。 如 果 能 够 使 用 Qt Designer 
自动 创建 一 些 信号 与 模 机 制 ， 那 就 更 好 了 。 本 节 将 通过 一 个 实战 性 肥 例 
来 介绍 信号 与 权 是 如 何 和 Qt Designer 结 合 的 。 

本 例 要 实现 的 功能 是 : 通过 一 个 模拟 打印 的 界面 来 详细 说 明 信 和 号 的 
使 用 ， 在 打印 时 可 以 设置 打印 的 份 数 、 纸 张 类 型 ， 触 发 “打印 ”按钮 后 ， 
将 执行 结果 显示 在 右 侧 ; 通过 QCheckBox (“全 屏 预 览 ” 复 选 框 来 选择 
是 否 通 过 全 屏 模式 进行 预览 ， 将 执行 结果 显示 在 右 侧 。 

按 F1 键 ， 可 以 显示 helpMessage 信 息 。 

首先 ， 使 用 Qt Designer 新 建 一 个 模板 名 为 “widget” 的 简单 窗口 ， 访 
窗口 文件 名 为 MainWinSignalSlog02.ui。 通 过 将 Widget Box 区 域 的 控件 
拖 忠 到 窗口 中 ， 实 现 了 如 图 7-16 所 示 的 界面 效果 。 











对 象 查 看 器 
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打印 份 数 : 0 3 - = label_2 TY QLabel 





numberSpinBox 29 QSpinBox 





= =z > printButton 2j QPushButton 
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图 7-16 


这 里 对 窗口 中 的 控件 进行 简要 说 明 ， 如 表 7-1 所 示 。 


表 7-1 


Er ERER 


QPushButton printButton 连接 emitPrintSignal 函数 的 绑 定 。 触 发 自 定 义 信号 
printSignal 的 发 射 


QPushButton previewButton 连接 emitPreviewSignal 函数 的 绑 定 。 触 发 自 定义 信号 
previewSignal 的 发 射 

将 界面 文件 转换 为 Python 文件 ， 需 要 输入 以 下 命令 把 
MainWinSignalSlog02.ui 文 件 转换 为 MainWinSignalSlog02.py 文 件 。 如 果 
命令 执行 成 功 ， 在 MainWinSignalSlog02.ui 的 同 级 目录 下 会 生成 一 个 同 
名 的 .py 文件 。 

pyuic5-o MainWinSignalSlog02.py MainWinSignalSlog02.ui 
查看 所 生成 的 MainWinSignalSlog02.py 文 件 ， 其 完整 代码 如 下 : 





from PyQt5 import QtCore, QtGui, QtWidgets 


class Ui Form(object): 


def setupUi(self, Form): 


Form. 
Form. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 


self 
self 


setObjectName ("Form") 

resize(715, 225) 

controlsGroup = QtWidgets.QGroupBox (Form) 
controlsGroup.setGeometry (QtCore.QRect(10, 20, 451, 151)) 
controlsGroup.setObjectName ("controlsGroup") 

widget = QtWidgets.QWidget (self.controlsGroup) 
widget.setGeometry(QtCore.QRect (10, 40, 411, 30)) 
widget.setObjectName ("widget") 

horizontalLayout = QtWidgets.QHBoxLayout (self.widget) 
horizontalLayout.setContentsMargins(0, 0, 0, 0) 
horizontalLayout.setObjectName ("horizontalLayout") 
label = QtWidgets.QLabel (self .widget) 
label.setObjectName ("label") 
horizontalLayout.addWidget (self.label) 


-numberSpinBox = QtWidgets.QSpinBox(self.widget) 
-numberSpinBox.setObjectName ("numberSpinBox") 

self. 
self. 


horizontalLayout.addWidget (self.numberSpinBox) 
styleCombo = QtWidgets.QComboBox (self.widget) 


self.styleCombo.setObjectName ("styleCombo") 
self.styleCombo.addItem("") 

self.styleCombo.addItem("") 

self.styleCombo.additem("") 

self.horizontalLayout.addWidget (self.styleCombo) 
self.label 2 = QtWidgets.QLabel (self.widget) 
self.label_2.setObjectName ("label 2") 
self.horizontalLayout.addWidget (self.label 2) 
self.printButton = QtWidgets.QPushButton (self.widget) 
self.printButton.setObjectName ("printButton") 
self.horizontalLayout.addWidget (self.printButton) 
self.widgetl = QtWidgets.QWidget (self.controlsGroup) 
self.widgetl.setGeometry (QtCore.QRect(10, 100, 201, 30)) 
self.widgetl.setObjectName ("widget1") 
self.horizontalLayout 2 = QtWidgets.QHBoxLayout (self.widget1) 
self.horizontalLayout 2.setContentsMargins(0, 0, 0, 0) 
self.horizontalLayout 2.setObjectName ("horizontalLayout 2") 
self.previewStatus = QtWidgets.OCheckBox (self.widget1) 
self.previewStatus.setObjectName ("previewStatus") 
self.horizontalLayout 2.addWidget (self.previewStatus) 
self.previewButton = QtWidgets.QPushButton (self.widget1) 
self.previewButton.setObjectName ("previewButton") 

self. horizontalLayout 2.addWidget (self.previewButton) 
self.resultGroup = QtWidgets.QGroupBox (Form) 
self.resultGroup.setGeometry (QtCore.QRect (470, 20, 231, 151)) 
self.resultGroup.setObjectName ("resultGroup") 
self.resultLabel = QtWidgets.QLabel (self.resultGroup) 
self.resultLabel.setGeometry (QtCore.QRect(20, 30, 191, 101)) 
self.resultLabel.setObjectName ("resultLabel") 


self.retranslateUi (Form) 
QtCore.QMetaObject.connectSlotsByName (Form) 


def retranslateUi(self, Form): 
_translate = QtCore.QCoreApplication.translate 
Form.setWindowTitle(_translate("Form", "打印 控件 ") ) 
self.controlsGroup.setTitle( translate ("Form", "打印 控制 ")) 
self.label.setText(_translate("Form", "打印 份 数 :")) 
self.styleCombo.setItemText(0, translate("Form", "A3")) 
self.styleCombo.setItemText(1, translate("Form", "A4")) 
self.styleCombo.setItemText(2, _translate("Form", "A5")) 
self.label_2.setText(_translate("Form", "纸张 类 型 :")) 


self.printButton.setText ( _ translate("Form"，" 打 印 ") ) 
self.previewStatus .setText( translate ("Form",，, "全 屏 预 览 ")) 
Ww 


self.previewButton.setText (_translate("Form", "预览 ")) 


self.resultGroup.setTitle(_translate("Form", "操作 结果 ")) 





selft-.resulthLabel .setText( translate ("Form”, 
"<html><head/><body><p><br/></p></body></htm1>") ) 


为 了 使 窗口 的 显示 和 业务 逻辑 分 离 ， 再 新 建 一 个 调用 窗口 显示 的 文 


件 CallMainWinSignalSlog02.py， 在 调用 类 中 添加 多 个 自 定 义 信 号 ， 并 与 
槽 函数 进行 绑 定 。 其 完整 代码 如 下 : 


import sys 

from PyOt5.QtWidgets import QApplication , QMainWindow 
from MainWinSignalSlog02 import Ui Form 

from PyOt5.QtCore import pyqtSignal , Qt 


class MyMainWindow (QMainWindow, Ui Form): 
helpSignal = pyqtSignal (str) 
printSignal = pyqtSignal (list) 
# 声明 一 个 多 重 载 版 本 的 信号 ， 包 括 一 个 带 int 和 str 类 型 参数 的 信号 ， 以 及 带 str 类 
型 参数 的 信号 
previewSignal = pyqtSignal([int,str],[str]) 


def init (self, parent=None) : 
super (MyMainWindow, self). init (parent) 
self.setupUi (self) 
self.initUI () 


def initUI (self): 
self. helpSignal.connect (self.showHelpMessage) 
self.printSignal.connect (self.printPaper) 
self.previewSignal [str] .connect (self.previewPaper) 
self.previewSignal[int,str].connect (self. 


previewPaperWithArgs) 


self.printButton.clicked.connect (self.emitPrintSignal) 
self.previewButton.clicked.connect (self.emitPreviewSignal) 


# 发 射 预览 信号 
def emitPreviewSignal (self): 
if self.previewStatus.isChecked() == True: 
self.previewSignal[int,str].emit(1080," Full Screen") 
elif self.previewStatus.isChecked() == False: 
self.previewSignal[str].emit ("Preview") 


# 发 射 打印 信号 

def emitPrintSignal (self): 
pList = [] 
pList.append(self.numberSpinBox.value() ) 
pList.append(self.styleCombo.currentText () ) 
self.printSignal.emit (pList) 


def printPaper(self,list): 
self.resultLabel.setText ("打印 : "+" 份 数 : "+ str(list[0]) +" 纸 


os et (dst Edy 


def previewPaperWithArgs (self,style,text): 
self.resultLabel.setText (str(style)+text) 


def previewPaper (self, text): 
self.resultLabel.setText (text) 


+ 重 载 按键 事件 
def keyPressEvent (self, event): 
if event: key (O) == Ob. Key Fl; 


self.helpSignal.emit ("help message") 


# 显示 帮助 信息 
def showHelpMessage(self,message) : 
self.resultLabel.setText (message) 


self.statusBar() .showMessage (message) 


if name ==" _ main": 


app = QApplication(sys.argv) 


win MyMainWindow () 
win.show() 


sys.exit(app.exec_()) 
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打印 控制 
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图 7-17 


代码 分 析 : 

在 上 面 的 例子 中 ， 通 过 pyqtSignal0 定 义 了 三 个 信号 ， 即 
helpSignal、 i i 。 其 中 ，helpSignal 为 str 参 数 类 型 
的 信号 ; printSignal 为 list 参 数 类 型 的 信号 ;previewSignal 为 一 个 多 重 载 
版 本 的 信号 ， 包 括 一 个 带 int 和 str 类 型 参数 的 信号 ， 以 及 珊 str 类 型 参数 的 
信和 号。 

helpSignal=pyqtSignal(str) 
printSignal=pyqtSignal(list) 
previewSignal=pyqtSignal([int,str],[str]) 

对 于 绑 定 信号 与 槽 ， 这 里 着 重 说 明 多 重 载 版 本 的 信号 绑 定 。 
previewSignal 有 两 个 版 本 ， 即 previewSignal(str) 和 和 
previewSignal(int,str)。 由 于 存在 两 个 版 本 ， 因 此 在 绑 定 时 需要 显 式 指定 

言 号 与 槽 的 绑 定 关 系 。 
self.helpSignal.connect(self.showHelpMessage) 
self.printSignal.connect(self.printPaper) 
self.previewSignal[str].connect(self.previewPaper) 


self.previewSignall[int,str].connect(self.previewPaperWithArgs) 


[str] 参 数 的 previewSignal 信 号 绑 定 previewPaper()，[int,str] 参 数 的 
previewSignal 信 号 绑 定 previewPaperWithArgs0。 多 重 载 版 本 的 信号 发 射 
时 ， 要 注意 发 射 信号 传递 的 参数 类 型 和 个 数 ， 在 Qt 的 通信 机 制 中 ， 根 据 
所 传递 信号 的 参数 类 型 和 个 数 ， 连 接 到 不 同 的 槽 函数 。 

def emitPreviewSignal(self): 
if self.previewStatus.isChecked()==True: 
self.previewSignall[int,str].emit(1080," Full Screen") 
elif self.previewStatus.isChecked()==False: 
self.previewSignal[str].emit("Preview") 
言 写 发 射 时 可 以 传递 Python 数 据 类 型 的 参数 ， 本 例 中 的 printSignal 
言 写 可 以 传递 list 类 型 的 参数 pList。 
def emitPrintSignal(self): 
pList=[] 
pList.append(self.numberSpinBox.value() ) 
pList.append(self.styleCombo.currentText()) 
self.printSignal.emit(pList) 

通过 复写 keyPressEvent() 方 法 ， 对 Fl 键 进行 功能 扩展 。 在 
Windows 的 大 部 分 应 用 中 ， 都 会 使 用 一 些 快 捷 键 来 快速 地 完成 菏 些 特定 
的 功能 。 比 如 按 F1 键 ,会 快速 调 出 帮助 界面 。 这 里 通过 复写 
keyPressEvent() 方 法 模拟 发 射 所 需 的 信号 ， 来 完成 对 应 的 任务 。 

# 重 载 按键 事件 
def keyPressEvent(self,event): 
if event.key()==Qt.Key_F1: 








self.helpSignal.emit("help message") 
注意 
(1) 自 定义 信号 在 _init 0 函数 之 前 定义 。 
(2) 自 定义 信号 可 以 传递 如 str、int、list、object、float、tuple、 





dict 等 很 多 类 型 的 参数 。 
(3) 注意 signal 和 slot 的 调用 逻辑 ， 避 免 signal 和 slot 之 间 出 现 死 循 
环 ， 比 如 在 slot 方 法 中 继续 发 射 该 信号 。 
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最 简单 的 多 线程 使 用 方法 是 利用 QThread 函 数 ， 如 下 代码 〈 见 
PyQt5/Chapter07/qt07_signalSlot04.py) 展示 了 QThread 函 数 和 信和 号 与 村 
简单 的 结合 方法 。 其 完整 代码 如 下 : 


from PyQt5.0tWidgets import QApplication ,QWidget 
from PyQt5.QtCore import QThread , pyqtSignal 
import sys 


class Main (QWidget): 
det init (self, parent = None) : 


super (Main, self). init (parent) 


# 创建 一 个 线程 实例 并 设置 名 称 、 变 量 、 信 号 与 模 
self.thread = MyThread () 
self.thread.setIdentity("thread1") 
self.thread.sinOut.connect (self.outText) 
self.thread.setVal (6) 


def outText (self, text): 
print (text) 


class MyThread(QThread) : 
sinOut = pyqtSignal (str) 


def init  (self,parent=None) : 


super (MyThread,self). init (parent) 
self.identity = None 


def setIdentity(self,text): 
self.identity = text 


def setVal(self,val): 
self.times = int (val) 
# 执行 线程 的 run 方法 
selt SEaren) 


def run (self): 
while self.times > 0 and self.identity: 
# 发 射 信号 
self.sinOut.emit (self.identity+"==>"+str(self.times) ) 


self.times -= 1 


if _ name == " main ': 
app = QApplication(sys.argv) 
main = Main() 
main. show () 


sys.exit (app exec ()) 


运行 结果 如 下 : 
thread1== > 6 
thread1== > 5 
thread1== > 4 
thread1== > 3 
thread1== > 2 
thread1== > 1 








有 时 在 开发 程序 时 经 常会 执行 一 些 耗 时 的 操作 ， 这 样 就 会 导致 春 面 
卡 顿 ， 这 也 是 多 线程 的 应 用 范围 之 一 一 一 为 了 解决 这 个 问题 ， 我 们 可 以 
创建 多 线程 ， 使 用 主线 程 更 新 界面 ， 使 用 子 线程 实时 处 理 数据 ， 最 后 将 
结果 显示 到 界面 上 。 








本 例 中 ， 定 义 了 一 个 后 台 线 程 类 BackendThread 来 模拟 后 台 耗 时 操 
作 ， 在 这 个 线程 类 中 定义 了 信号 update_date。 使 用 BackendThread 线程 
类 在 后 台 处 理 数 据 ， 每 秒 发 射 一 次 和 目 定义 信号 update_date。 

在 初始 化 窗口 界面 时 ， 定 义 后 台 线 程 类 BackendThread， 并 把 线程 
类 的 信号 update_date 连接 到 槽 函数 handleDisplay()。 这 样 后 台 线 程 每 发 
财 一 次 信号 ， 就 可 以 把 最 新 的 时 间 值 实时 显示 在 前 台 徐 口 的 QLineEdit 
文本 对 话 框 中 。 

本 例文 件 名 为 PyQt5/Chapter07/qt07_signalSlotThreaad.py， 其 完整 代 
人 码 如 下 : 











from PyQt5.QtCore import QThread , pyqtSignal, QDateTime 
from PyQt5.QtWidgets import QApplication, QDialog, QLineEdit 
import time 

import sys 


class BackendThread (QThreadqd) : 
# 通过 类 成 员 对 象 定义 信号 
update date = pyqtSignal (str) 


# ASP Hiv Ht 
def run(self): 
while True: 
data = QDateTime.currentDateTime () 
currTime = data.toString("yyyy-MM-dd hh:mm:ss") 
self.update date.emit( str(currTime) ) 
time.sleep (1) 


class Window (QDialog): 
def init (self): 

Dialog. init (self) 
self.setWindowTitle('PyQt 5 界面 实时 更 新 例子 ') 
self.resize(400, 100) 
self.input = QLineEdit (self) 
self.input.resize(400, 100) 
self.initUI () 


def initUI (self): 
# 创建 线程 
self.backend = BackendThread() 
# 连接 信号 
self.backend.update_ date.connect (self.handleDisplay) 
# 开始 线程 
self.backend.start () 


# 将 当前 时 间 输 出 到 文本 框 
def handleDisplay(self, data): 
self.input.setText (data) 


Le name S= I mein "3 
app = QApplication(sys.argv) 
win = Window () 
win.show() 
sys.exit(app.exec_ ()) 


运行 脚本 ， 显 示 效 果 如 图 7-18 所 示 。 
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图 7-18 
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5.3.3 节 说 过 ，PyQt 为 事件 处 理 提 供 了 两 种 机 制 : 高 级 的 信号 与 槽 机 
制 ， 以 及 低级 的 事件 处 理 机 制 。 我 们 知道 ， 信 号 与 槽 只 能 解决 窗口 控件 
的 茶 些 特定 行为 ， 如 果 要 对 窗口 控件 做 更 深层 次 的 研究 ， 如 目 定义 窗口 
等 ， 则 需要 使 用 低级 的 事件 处 理 机 制 。 

事件 处 理 机 制 本 身 很 复杂 ， 是 PyQt 压 层 的 东西 。 笔 者 一 直 都 把 事件 
处 理 机 制 当 作 信号 与 槽 机 制 的 补充 ， 当 采用 信和 号 与 槽 机 制 处 理 不 了 时 ， 
才 会 考虑 使 用 事件 处 理 机 制 。 基 于 此 ， 本 书 把 事件 处 理 机 制 放 在 信号 与 


槽 这 个 章节 中 进行 介绍 。 
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言 号 与 槽 可 以 说 是 对 事件 处 理 机 制 的 高 级 封装 ， 如 采 说 事件 是 用 来 
创建 窗口 控件 的 ， 那 么 信号 与 槽 就 是 用 来 对 这 个 窗口 控件 进行 使 用 的 。 
比如 一 个 按钮 ， 当 我 们 使 用 这 个 按钮 时 ， 只 关心 dicked 信 号 ， 至 于 这 个 
按钮 如 何 接收 并 处 理 鼠 标点 击 事件 ， 然 后 再 发 射 这 个 信号 ， 则 不 用 关 
心 。 但 是 如 果 要 重 载 一 个 按钮 ， 这 时 就 要 关心 这 个 问题 了 。 比 如 可 以 改 
变 它 的 行为 : 在 鼠标 按键 按 下 时 触发 clicked 信 和 号， 而 不 是 在 释放 时 。 











7.4.2 常见 类 型 





PyQt 是 对 Qt 的 封闭，Qt 程 序 是 事件 驱动 的 ， 它 的 每 个 动作 部 由 幕后 
某 个 事件 所 触发 。Qt 事 件 的 类 型 有 很 多 ， 常 见 的 Qt 事件 如 下 。 

o 键盘 事件 ;按键 按 下 和 松 开 。 

e 鼠标 事件 : 鼠标 指针 移动 、 鼠 标 按键 按 下 和 松 开 。 


o 拖 放 事 件 : 用 鼠标 进行 拖 放 。 
o 滚轮 事件 ;鼠标 滚轮 滚动 。 
o 绘 屏 事件 : 重 绘 屏 幕 的 某 些 部 分 。 
定时 事件 : 定时 器 到 时 。 
焦点 事件 : 键盘 焦点 移动 。 
e 进入 和 离开 事件 : 鼠标 指针 移入 Widget 内 ， 或 者 移出 。 
o 移动 事件 : Widget 的 位 置 改 变 。 
大 小 改变 事件 Widget 的 大 小 改变 。 
显示 和 隐藏 事件 :Widget 显示 和 隐藏 。 
e 窗口 事件 窗口 是 否 为 当前 窗口 。 
还 有 一 些 常见 的 Qt 事件 ， 比 如 Socket 事件 、 剪 贴 板 事件 、 字 体 改 
变 事 件 、 布 局 改变 事件 等 。 











7.4.3 下 理 A ITY 





PyQt 提 供 了 如 下 5 种 事件 处 理 和 过 小 方法 (由 弱 到 强 ) ， 其 中 只 有 
前 两 种 方法 使 用 最 频 楷 。 

(1) 重新 实现 事件 函数 

比如 mousePressEvent()、keyPressEvent()、paintEvent()。 这 是 最 常 
规 的 事件 处 理 方法 。 

(2) 重新 实现 QObject.event() 

一 般 用 在 PyQt 没 有 提供 该 事件 的 处 理 函 数 的 情况 下 ， 即 增加 新 事件 
时 。 

(3) ZR SPR YE at 

如 果 对 QObject 调 用 installEventFilter， 则 相当 于 为 这 个 QObject 安 装 
了 一 个 事件 过 小 器， 对 于 QObject 的 全 部 事件 来 说 ， 它 们 都 会 先 传递 到 
事件 过 小 函数 eventFilter 中 ， 在 这 个 函数 中 我 们 可 以 抛 莽 或 者 修改 这 些 








事件 ， 比 如 可 以 对 自己 感 兴趣 的 事件 使 用 自 定 义 的 事件 处 理 机 制 ， 对 其 
他 事件 使 用 默认 的 事件 处 理 机 制 。 由 于 这 种 方法 会 对 调用 
installEventFilter 的 所 有 QObject 的 事件 进行 过 小 ， 此 如 果 要 过 滤 的 事 
件 比 较 多 ， 则 会 降低 程序 的 性 能 。 
(4) 在 QApplication 中 安装 事件 过 滤器 
这 种 方法 比 上 一 种 方法 更 强大 : QApplication 的 事件 过 滤器 将 捕获 
所 有 QObject 的 所 有 事件 ， 而 且 第 一 个 获得 该 事件 。 也 就 是 说 ， 在 将 事 
件 发 送 给 其 他 任何 一 个 事件 过 滤器 之 前 〈 就 是 在 第 三 种 方法 之 前 ) ， 都 
会 先 发 送 给 QApplication 的 事件 过 滤器 。 
(5) 重新 实现 QApplication 的 notify0 方 法 
PyQt 使 用 notify0) 来 分 发 事件 。 要 想 在 任何 事件 处 理 器 之 前 捕获 事 
件 ， 唯 一 的 方法 就 是 重新 实现 QApplication 的 notify()。 在 实践 中 ， 在 调 
试 时 才 会 使 用 这 种 方法 。 














7.4.4 经 典 案例 分 析 


对 于 第 一 种 方法 : 重新 实现 事件 函数 ， 在 前 面 的 案例 中 已 经 涉及 
(8 JLCallMainWinSignalSlog02.py 文件 的 ”keyPressEvent 函数 的 重 
载 ) ， 其 实事 件 的 重 载 看 起 来 “高 大 上 ”， 使 用 起 来 却 很 简单 。 其 他 事件 
的 重 载 与 下 面 的 函数 差不多 。 
# 重 载 按键 事件 
def keyPressEvent(self,event): 
if event.key()==Qt.Key_F1: 
self.helpSignal.emit("help message") 
这 里 给 出 一 个 例子 (文件 名 为 PyQt5/Chapter07/event.py) ， 参 考 了 
GUI Rapid GUI Programming with Python and Qt 中 第 10 章 的 例子 ， 原 代 
码 是 PyQt 4 版 本 的 ， 现 在 笔者 把 它 修 改 为 PyQt 5 版 本 。 这 个 例子 比较 经 











典 ， 对 于 第 一 种 和 第 二 种 方法 都 有 涉及 ， 而 且 内 容 很 丰富 ， 基 本 包含 了 
我 们 对 事件 处 理 的 绝 大 部 分 需求 

笔者 对 本 例 的 绝 天 部 分 难点 都 做 了 注释 ， 有 经 验 的 读者 直接 看 代码 
也 可 以 理解 。 下 面 对 这 个 肥 例 的 几 个 关键 点 进行 说 明 。 

首先 是 类 的 建立 。 建 立 text 和 message 两 个 变量 ， 使 用 paintEvent K 
数 把 它们 输出 到 窗口 中 。 

update 函数 的 作用 是 更 新 窗口 。 由 于 在 窗口 更 新 过 程 中 会 触发 一 次 
paintEvent K 2 〈paintEvent 是 窗口 基 类 QWidget 的 内 部 函数 ) ， 因 此 在 
本 例 中 update 函 数 的 作用 等 同 于 paintEvent 函 数 。 


import sys 

from PyQt5.QtCore import (QEvent, QTimer, Qt) 

from PyQt5.QtWidgets import (QApplication, QMenu, QWidget) 
from PyQt5.QtGui import QPainter 


class Widget (QWidget): 
def init (self, parent=None): 
super (Widget, self). init (parent) 
self.justDoubleClicked = False 
self.key = "" 
self.text = "" 
self.message = "" 
self.resize(400, 300) 
self.move(100, 100) 
self.setWindowTitle ("Events") 
QTimer.singleShot (0, self.giveHelp) # 避免 受 窗口 大 小 重 绘 事件 的 影响 
可 以 把 参数 0 改 成 3000 (3 秒 ) ， 然 后 再 运行 ， 就 可 以 明白 这 行 代码 的 意思 


def giveHelp(self): 


self.text = "H S Ei BARR ib SR RAE 
self.update() # 重 绘 事件 ， 也 就 是 触发 paintEvent HA 


初始 化 运行 结果 如 图 7-19 所 示 。 


请 点 击 文 里 触 友 追踪 鼠标 功能 





图 7-19 
然后 是 重新 实现 窗口 关闭 事件 与 上 下 文 菜单 事件 。 对 于 上 下 文 菜单 


事件 ， 主 要 影响 message 变量 的 结果 ，paintEvent 负责 把 这 个 变量 在 窗 
口 底部 输出 。 结 果 如 图 7-20 和 图 7-21 所 示 。 
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开启 鼠标 跟踪 功能 . 
移动 一 下 鼠标 ! 
单 击 鼠 标 可 以 关闭 这 个 功能 
One 


Two 


Three 


图 7-20 
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开启 鼠标 跟踪 功能 


请 移动 一 下 鼠标 上 
单 击 鼠 标 可 以 关闭 六 个 功能 





Menu option One 
图 7-21 
绘制 事件 是 代码 的 核心 事件 ， 它 的 主要 作用 是 时 刻 跟踪 text 与 


message 这 两 个 变量 的 信息 ， 并 把 。 ”text 的 内 容 绘 制 到 窗口 的 中 部 ， 把 
message 的 内 容 绘制 到 窗口 的 底部 《保持 5 秒 后 就 会 被 清空 





''' 重 新 实现 绘制 事件 '' 
def paintEvent (self, event): 
text = self.text 
i = text.find("\n\n") 
if 1 >= 0: 
text = text[0:i] 
if self.key: # 若 触发 了 键盘 按键 ， 则 在 信息 文本 中 记录 这 个 按键 信息 
text += "\n\n 你 按 下 了 : (0}". format (self.key) 
painter = QPainter (self) 
painter.setRenderHint (QPainter.TextAntialiasing) 


painter.drawText (self.rect(), Qt.AlignCenter, text) # 绘制 信息 文本 的 
内 容 
if self.message: # 若 信 息 文 本 存在 ， 则 在 底部 居中 绘制 信息 ，5 秒 后 清空 信息 文本 


painter.drawText (self.rect(), Qt.AlignBottom | Qt.AlignHCenter, 


self.message) 
QTimer.singleShot (5000, self.clearMessage) 


QTimer.singleShot (5000, self.update) 


UAE OSCR a 
def clearMessage (self): 


self.message = "" 





接 下 来 是 重新 实现 调整 窗口 大 小 事件 ， 结 果 如 图 7-22 所 示 。 
"重新 实现 调整 窗口 大 小 事件 " 
def resizeEvent(self,event): 
self.text=" 调 整 窗口 大 小 为 : QSize({0},{1})".format( 
event.size().width(),event.size().height()) 


self.update() 


调整 窗口 大 小 为 : QSize(373，87) 





图 7-22 
实现 鼠标 释放 事件 ， 硅 为 双击 释放 ， 则 不 跟踪 鼠标 移动 ， 铬 为 单 击 


释放 ， 则 需要 改变 跟踪 功能 的 状态 ， 如 果 开 启 跟 踪 功 能 束 跟 踪 ， 否 则 束 
不 跟踪 。 结 果 如 图 7-23、 图 7-24 和 图 7-25 所 示 。 





'' ' 重 新 实现 鼠标 释放 事件 '' 


def mouseReleaseEvent (self, event): 


E 若 为 双击 释放 ， 则 不 跟踪 鼠标 移动 
# 若 为 单 击 释放 ， 则 需要 改变 跟踪 功能 的 状态 ， 如 果 开 启 跟踪 功能 就 跟踪 ， 否 则 就 不 跟踪 
if self.justDoubleClicked: 
self.justDoubleClicked = False 
else: 
self.setMouseTracking(not self.hasMouseTracking()) # 单 击 筷 标 
if self.hasMouseTracking(): 
self.text = "开启 鼠标 跟踪 功能 .\n" + \ 
"请 移动 一 下 和 鼠标 ! \n" + \ 
" 单 击 鼠标 可 以 关闭 这 个 功能 " 
else: 
self.text = "关闭 鼠标 跟踪 功能 .\n" + \ 
" 单 击 筷 标 可 以 开启 这 个 功能 " 
self.update () 
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你 双击 了 鼠标 





图 7-23 











开启 鼠标 跟踪 功能 
请 移动 一 下 鼠标 ! 
单 击 鼠 标 可 以 关闭 这 个 功能 








图 7-24 
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关闭 鼠标 跟踪 功能 . 


单 击 鼠 标 可 以 开启 文 个 功能 








图 7-25 





实现 鼠标 移动 与 双击 事件 ， 结 果 如 图 7-26 和 图 7-27 所 示 。 


' "重新 实现 鼠标 移动 事件 '' 
def mouseMoveEvent (self, event): 
if not self.justDoubleClicked: 
globalPos = self.mapToGlobal (event.pos())# 将 窗口 坐标 转换 为 屏幕 坐标 
self.text = """RiMaid: 
窗口 坐标 为 : QPoint({0}, {1}) 
屏幕 坐标 为 : QPoint({2}, {3}) """.format (event.pos().x(), 
event.pos().y(), globalPos.x(), globalPos.y() ) 
self.update() 


tT ' 重 新 实现 鼠标 双击 事件 ， tt 
def mouseDoubleClickEvent (self, event): 


self.justDoubleClicked = True 
self.text = "你 双击 了 息 标 " 


self.update () 


OB Events 
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鼠标 位 置 : 
窗口 坐标 为 : QFoint(195，80) 
屏幕 坐标 为 : QFoint (980，331) 








图 7-26 


你 双击 了 鼠标 








图 7-27 





实现 键盘 按 下 事件 ， 结 果 如 图 7-28 所 示 。 


国 Events 


开启 鼠标 跟踪 功能 . 
请 移动 一 下 鼠标 ! 


单 击 记 标 可 以 关闭 这 个 功能 


你 按 下 了 : PageDown 





图 7-28 











第 二 种 事件 处 理 方法 是 重 载 event 函 数 。 对 于 窗口 所 有 的 事件 都 会 传 
递 给 event 函 数 ，event 函 数 会 根据 事件 的 类 型 ， 2 配给 不 同 的 函 
数 进行 处 理 。 比 如 对 于 绘图 事件 ，event 222224 paintEvent 函数 处 理 ; 
对 于 鼠标 移动 事件 ，event 会 交 ARIEN ue 函数 处 理 ， 对 于 键盘 
按 下 事件 ，event 会 交 给 keyPressEvent 疯 数 处 理 。 有 一 种 特殊 情况 是 对 
Tab 键 的 触发 行为 ，event 函 数 对 Tab 键 的 处 理 机 制 是 把 焦点 从 当前 窗口 
控件 的 位 置 切 换 到 Tab 键 次 序 中 下 一 个 窗口 控件 的 位 置 ， 并 返回 True， 
而 不 是 交 给 keyPressEvent 函 数 处 理 。 因 此 这 里 需要 在 event 函 数 中 对 按 下 
Tab 键 的 处 理 逻 辑 重 新 改写 ， 使 它 与 键盘 上 普通 的 键 没什么 不 同 。 结 果 
如 图 7-29 所 示 。 

"重新 实现 其 他 事件 ， 适 用 于 PyQt 没 有 提供 该 事件 的 处 理 函 数 的 
情况 ，Tab 键 由 于 涉及 焦点 切换 ， 不 会 传递 给 keyPressEvent， 因 此 盐 
要 在 这 里 重新 定义 " 














def event(self,event): 
if (event.type)==QEvent.KeyPress and 
event.key()==Qt.Key_Tab): 
self. key="{Eevent() F fi 3k Tab He" 
self.update() 
return True 


return QWidget.event(self,event) 


TANS 


动 一 下 


单 击 居 标本 以 关闭 这 个 功能 
你 按 下 了 : 在 event 〇 中 捕获 Tab 键 





图 7-29 


第 三 种 事件 处 理 方 法 的 使 用 也 很 简单 ， 案 例 见 
PyQt5/Chapter07/event_filter.py， 代 码 如 下 : 


$ Coding: utt-8 =*= 

from PyQt5.QtGui import * 
from PyOt5.QtCore import * 
from PyQt5.QtWidgets import * 


import sys 


class EventFilter(QDialog): 
def init. (self, parent=None):s 
super (EventFilter, self). init (parent) 
self.setWindowTitle ("事件 过 滤器 ") 


self.labell = QLabel ("H A=") 
self.label2 QLabel ("请 点 击 ") 
self.label3 = QLabel ("请 点 击 ") 
self.LabelState = QLabel ("test") 


self.imagel = QImage("images/cartoonl.ico") 
self.image2 = QImage("images/cartoonl.ico") 
self.image3 = QImage("images/cartoonl.ico") 


self.width = 600 
self.height = 300 


self.resize(self.width, self.height) 


self.labell.installEventFilter (self) 
self.label2.installEventFilter (self) 
self.label3.installEventFilter (self) 


mainLayout = QGridLayout (self) 
mainLayout.addWidget(self.labell, 500, 0) 
mainLayout.addWidget (self.label2, 500, 1) 
mainLayout.addWidget (self.label3, 500, 2) 
mainLayout.addWidget (self.LabelState, 600, 1) 
self.setLayout (mainLayout) 


def eventFilter(self, watched, event): 
if watched == self.labell: # 只 对 1labell 的 点 击 事件 进行 过 滤 ， 重 写 其 行 
为 ， 其 他 事件 会 被 忽略 
if event.type() == QEvent.MouseButtonPress: # Bx Kirik FS 
件 进行 过 滤 ， 重 写 其 行为 


mouseEvent = QMouseEvent (event) 


if mouseEvent.buttons() == Qt.LeftButton: 
self.LabelState.setText (" 按 下 和 鼠标 左 键 ") 

elif mouseEvent.buttons() == Qt.MidButton: 
self.LabelState.setText ("4 F Rar? i Bt") 

elif mouseEvent.buttons() == Qt.RightButton: 


self.LabelState.setText (" 按 下 和 鼠标 右键 ") 


' "转换 图 片 大 小 1 
transform = QTransform() 
transtorm.scale(Orus, O55) 
tmp = self.imagel.transformed (transform) 
self.labell.setPixmap (QPixmap. fromImage (tmp) ) 

if event.type() == QEvent.MouseButtonRelease: # 这 里 对 鼠标 释放 

事件 进行 过 滤 ， 重 写 其 行为 
self.LabelState.setText ("HA RARE") 
self.labell.setPixmap (QPixmap.fromImage (self.imagel) ) 
return QDialog.eventFilter(self, watched, event) # 对 于 其 他 情况 ， 


会 返回 系统 默认 的 事件 处 理 方法 


if _ name == !_ main '; 
app = QApplication(sys.argv) 
dialog = EventFilter () 
dialog.show () 
app.exec () 


运行 结果 如 图 7-30 和 图 7-31 所 示 。 


国 事件 过 污 露 








‘es 请 点 击 请 点 击 
按 下 鼠标 左 键 
图 7-30 
D 事件 过 小 器 ? 4 
€ JO 二 


Ws 请 点 击 请 点 击 


释放 鼠标 按键 





图 7-31 


对 于 使 用 事件 过 滤器 ， 关 键 是 要 做 好 两 步 。 


对 要 过 滤 的 控件 设置 installEventFilter， 这 些 控件 的 所 有 事件 都 会 被 
eventFilter 函 数 接收 并 处 理 。installEventFilter 的 使 用 方法 如 下 : 
self.label1.installEventFilter(self) 
self.label2.installEventFilter(self) 
self.label3.installEventFilter(self) 
在 eventFilter 函数 中 处 理 这 些 控件 的 事件 信息 。 下 面 代码 的 意思 是 
这 个 过 滤器 只 对 label1 的 事件 进行 处 理 ， 并 且 只 处 理 它 的 鼠标 按 下 事件 
(MouseButtonPress) 和 鼠标 释放 事件 (MouseButtonRelease ) 








def eventFilter(self, watched, event): 
if watched == self.labell: # 只 对 1labell 的 点 击 事件 进行 过 滤 ， 重 写 其 行为 ， 
其 他 事件 会 被 忽略 
if event.type() == QEvent.MouseButtonPress: # 这 里 对 和 鼠标 按 下 事件 进 
行 过 滤 ， 重 写 其 行为 
mouseEvent = QMouseEvent (event) 
if mouseEvent.buttons() == Qt.LeftButton: 
self.LabelState.setText (" 按 下 和 鼠标 左 键 ") 
elif mouseEvent.buttons() == Qt.MidButton: 
self.LabelState.setText (" 按 下 和 鼠标 中 间 键 ") 


elif mouseEvent.buttons() == Qt.RightButton: 
self.LabelState.setText (" 按 下 鼠标 右键 ") 


' "转换 图 片 大 小 1 
transform = QTransform() 
Eranstorm. scale (055, 0.5) 


tmp = self.imagel.transformed (transform) 


self.labell.setPixmap (QPixmap.fromImage (tmp) ) 
if event.type() == QEvent.MouseButtonRelease: # ABM MA Se 
进行 过 滤 ， 重 写 其 行为 
self.LabelState.setText (" 释 放 和 鼠标 按键 ") 
self.labell.setPixmap (QPixmap.fromImage (self.imagel) ) 
return QDialog.eventFilter(self, watched, event) # 对 于 其 他 情况 ， 会 返 
回 系统 默认 的 事件 处 理 方法 


注意 到 如 下 4 行 代码 : 
"转换 图 片 大 小 " 
transform=QTransform() 
transform.scale(0.5,0.5) 
tmp=self.image1.transformed(transform) 
self.label1.setPixmap(QPixmap.fromImage(tmp)) 
IAAT FS AY oak FE ee MARK PO BE, LS OP label RERA RA HET 
缩放 【〈 长 和 宽 各 缩放 一 半 ) 。 
第 四 种 事件 处 理 方法 〈 在 QApplication 中 安装 事件 过 滤器 ) 的 使 用 
也 非常 简单 ， 与 第 三 种 事件 处 理 方法 相 比 ， 只 需要 简单 地 修改 两 处 代码 
即 可 。 
屏蔽 三 个 label 标 签 控件 的 installEventFilter 人 代码: 
# self label1.installEventFilter(self) 
# self label2.installEventFilter(self) 
# self label3.installEventFilter(self) 














对 于 在 QApplication 中 安装 installEventFilter， 下 面 代 码 的 意思 是 
dialog 的 所 有 事件 都 要 经 过 eventFilter 函 数 处 理 ， 而 不 仅仅 是 三 个 标签 控 
件 的 事件 。 

if name ==' main _': 


app=QApplication(sys.argv) 
dialog=EventFilter() 
app.installEventFilter(dialog) 
dialog.show() 
app.exec_() 
案例 见 。 PyQt5/Chapter07/event_filter2.py， 由 于 与 前 面 代码 非常 相 
似 ， 这 里 束 不 列举 了 。 运 行 结果 同 图 7-30 和 图 7-31。 
为 了 更 好 地 展示 第 四 种 事件 处 理 方法 与 第 三 种 的 区 别 ， 这 里 在 





eventFilter 函数 中 添加 了 一 行 代 码 : 
def eventFilter(self,watched,event): 
print(type(watched)) 
cmd 寡 口 的 输出 结果 如 下 : 
class 'PyQt5.QtGui.QWindow' > 
< class 'PyQt5.QtWidgets.QWidget' > 
< class 'PyQt5.QtWidgets.QWidget' > 
< class 'PyQt5.QtWidgets.QWidget' > 
< class 'PyQt5.QtGui.QWindow' > 
< class 'PyQt5.QtWidgets.QWidget' > 
< class 'PyQt5.QtWidgets.QWidget' > 
< class 'PyQt5.QtWidgets.QWidget' > 
< class 'PyQt5.QtWidgets.QWidget' > 
< class 'PyQt5.QtWidgets.QWidget' > 
< class 'PyQt5.QtGui.QWindow' > 
< class '__main__.EventFilter' > 
< class '__main__.EventFilter' > 
< class 'PyQt5.QtGui.QWindow' > 
< class '__main__.EventFilter' > 
< class '__main__.EventFilter' > 
< class 'PyQt5.QtWidgets.QLabel' > 
< class '__main__.EventFilter' > 
< class 'PyQt5.QtWidgets.QLabel' > 
< class '__main__.EventFilter' > 
< class 'PyQt5.QtWidgets.QLabel' > 
< class '__main__.EventFilter' > 
< class 'PyQt5.QtWidgets.QLabel' > 


< class '__main__.EventFilter' > 
< class '__main__.EventFilter' > 
< class '__main__.EventFilter' > 
< class 'PyQt5.QtWidgets.QLabel' > 
< class 'PyQt5.QtWidgets.QLabel' > 
可 见 。 第 四 种 事件 处 理 方法 确实 过 小 了 所 有 事件 ， 而 不 像 第 三 种 方 
法 那样 只 过 滤 三 个 标签 控件 的 事件 。 
对 于 第 五 种 事件 处 理 方法 ， 由 于 在 实际 中 基本 用 不 到 ， 所 以 这 里 不 
再 介绍 。 





7.5 窗口 数据 传递 





在 开发 程序 时 ， 如 果 这 个 程序 只 有 一 个 窗口 ， 则 应 该 关心 这 个 窗口 
里 面 的 各 个 控件 之 间 是 如 何 传递 数据 的 ， 如 果 这 个 程序 有 多 个 窗口 ， 那 
么 还 应 该 关心 不 同 的 窗口 之 间 是 如 何 传递 数据 的 ， 这 束 是 本 市 要 解决 的 
问题 。 本 市 首先 给 出 一 个 例子 ， 说 明 在 一 个 窗口 中 不 同 控 件 之 间 的 数据 
是 如 何 传递 的 。 对 于 多 窗口 的 情况 ， 一 般 有 两 种 解决 方法 ， 其 中 一 种 是 
主 寡 口 获取 子 窗 口中 控件 的 属性 ， 夯 一 种 是 通过 信号 与 槽 机制， 一 般 是 
子 窗口 通过 发 射 信号 的 形式 传递 数据 ， 主 窗口 的 槽 函数 获取 这 些 数据 。 














MZ 
— fio 





对 于 具有 单一 窗口 的 程序 来 说 ， 一 个 控件 的 变化 会 影响 另 一 个 控件 
的 变化 ， 这 种 变化 利用 信号 与 槽 机 制 非常 容易 解决 。 

本 例文 件 名 为 PyQt5/Chapter07/qt07_winSignalSlot06.py， 根 据 前 面 
所 学 的 知识 ， 这 个 例子 应 该 很 好 理解 。 其 完整 代码 如 下 : 








import sys 
from PyQt5.QtWidgets import 

QWidget, OLCDNumber, QSlider, QOVBoxLayout, QApplication 
from PyQt5.QtCore import Qt 


class WinForm(QWidget) : 
def _ init (self): 
super (). anit () 
self. Ini tür 


def initUI (self): 
# 先 创 建 滑 块 和 LCD 控件 
lcd = QLCDNumber (self) 
slider = QSlider(Qt.Horizontal, self) 


vBox = QVBoxLayout () 
vBox.addWidget (lcd) 
vBox.addWidget (slider) 


self.setLayout (vBox) 
# valueChanged()# QSlider 的 一 个 信号 函数 ， 只 要 slider 的 值 发 生 改 变 ， 它 
就 会 发 射 一 个 信号 ， 然 后 通过 connect 连接 信号 的 接收 控件 ， 也 就 是 1cd 


slider.valueChanged.connect (lcd.display) 


self.setGeometry (300, 300,350,150) 
self.setWindowTitle ("45 54: 连接 滑 块 LCD") 


if name == 1 fain 1: 


app = QApplication(sys.argv) 


form = WinForm() 


form. show () 


sys.exit(app.exec_ ()) 


运行 脚本 ， 显 示 效 果 如 图 7-32 所 示 。 


国 S518 : 连接 滑 块 LCD 








图 7-32 


代码 分 析 : 
首先 ， 创 建 滑 块 和 LCD 控 件 。 
Icd=QLCDNumber(self) 
slider=QSlider(Qt.Horizontal,self) 
然后 ， 通 过 QVBoxLayout 设 置 布 局 。 
vBox=QVBoxLayout() 
vBox.addWidget(Icd) 
vBox.addWidget(slider) 
最 后 ， 连 接 QSlider 控 件 的 valueChanged0O 信 号 函数 和 LCD 面 板 控 件 
的 display0 槽 函数 。 
valueChanged() 古 QSlider 的 一 个 信号 函数 ， 只 要 slider 的 值 发 生 改 
变 ， 它 就 会 发 射 一 个 信号 。 还 可 以 设置 参数 控制 信号 在 什么 时 候 发 射 ， 
然后 通过 connect 连 接 信号 的 接收 控件 ， 也 融 是 lcd。 模 是 对 信和 号 的 响 
应 ， 这 里 是 lcd.display， 即 更 新 LCD 面 板 的 数字 信息 。 
slider.valueChanged.connect(Icd.display) 
除  valueChanged():7 4b, QSlider ”还 有  sliderPressured(). 
sliderMoved()、sliderReleased() 等 信号 函数 ， 详 细 信 息 可 参考 PyQt 官 方 











文档 。 


7.5.2 多 窗口 数据 传递 :调用 属性 





在 PyQt 编 程 过 程 中 ， 经 常会 
个 参数 写 到 一 个 窗口 中 ， 主 窗口 
钮 ， 调 用 对 话 框 ， 在 对 话 框 中 进 和 
返回 给 主 窗口 。 

PyQt 提 供 了 一 些 标准 的 对 话 框 类 ， 用 于 输入 数据 、 修 改 数据 、 更 改 
应 用 的 设置 等 ， 常 见 的 有 QFileDialog、QInputDialog、QColorDialog、 
QFontDialog 等 。 在 不 同 的 窗口 之 间 传 参 有 两 种 常用 的 方式 : 一 种 是 在 
自 定 义 对 话 框 之 间 通 过 属性 传 参 ， 另 一 种 是 在 窗口 之 间 使 用 信和 号 与 槽 机 
制 传 参 。 本 节 主 要 介绍 前 一 种 方式 。 

在 这 个 例子 中 ， 将 自 定 义 对 话 框 作 为 一 个 子 窗 口 ， 后 面 会 新 建 一 个 
主 窗口 来 调用 这 个 子 窗口 的 属性 。 本 例文 件 名 为 
PyQt5/Chapter07/transParam/ DateDialog.py， 其 完整 代码 如 下 : 


遇 到 输入 或 选择 多 个 参数 的 问题 。 把 多 
会 显得 很 爱 肿 ， 所 以 一 般 是 添加 一 个 按 
J 参数 的 选择 ， 关 闭 对话 框 时 将 参数 值 











from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyOt5.QtWidgets import * 


class DateDialog(QDialog) : 
def init (self, parent = None): 
super (DateDialog, self). init (parent) 
self.setWindowTitle('DateDialog') 


# 在 布局 中 添加 控件 

layout = QVBoxLayout (self) 

self.datetime = QDateTimeEdit (self) 
self.datetime.setCalendarPopup (True) 
self.datetime.setDateTime (QDateTime.currentDateTime () ) 
layout.addWidget (self.datetime) 


# 使 用 两 个 按钮 (Ok 和 Cancel) PF i#4 accept () fe reject () HHA 
buttons = QDialogButtonBox ( 
QDialogButtonBox.Ok | QDialogButtonBox.Cancel, 
Qt.Horizontal, self) 
buttons.accepted.connect (self.accept) 
buttons.rejected.connect (self.reject) 
layout.addWidget (buttons) 


# 从 对 话 框 中 获取 当前 日 期 和 时 间 
def dateTime (self): 


return self.datetime.dateTime () 


# 使 用 静态 函数 创建 对 话 框 并 返回 (date, time, accepted) 
@staticmethod 
def getDateTime (parent = None): 

dialog = DateDialog (parent) 


result = dialog.exec () 


date = dialog.dateTime () 
return (date.date(), date.time(), result == QDialog.Accepted) 


C1) 使 用 两 个 按钮 〈Ok 和 Cancel) 分 别 连接 accept0 和 rejectO 醒 函 
数 。 

(2) 在 类 中 定义 一 个 静态 函数 getDateTime()， 该 静态 函数 返回 3 个 
时 间 值 。 原 理 是 利用 静态 函数 的 特性 ， 在 静态 函数 中 实例 化 DateDialog 
类 ， 并 调用 dialog.exec_(0) 函 数 来 显 式 执行 对 话 框 。 通 过 dialog.exec_() 的 
返回 值 来 判断 用 户 单 击 的 是 Ok 按 钮 还 是 Cancel 按 钮 ， 然 后 做 出 下 一 步 判 

新 建 一 个 调用 对 话 框 的 主 窗口 文件 CallDialogMainWin.py， 保 存 路 

径 为 PyQt5/Chapter07/transParam/CallDialogMainWin.py， 其 完整 代码 如 
Pe 








运行 脚本 ， 显 示 效 果 如 图 7-33 和 图 7-34 所 示 。 
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图 7-34 


代码 分 析 : 

在 主 窗口 中 调用 对 话 框 有 两 种 方法 ， 本 例 中 这 两 种 方法 的 操作 是 一 
样 的 “本质 上 也 没有 什么 不 同 ) ， 都 需要 单 击 “ 弹 出 对 话 框 ”按钮 ， 在 对 
话 框 的 时 间 日 期 控件 中 选择 日 期 ， 则 会 把 所 选中 的 日 期 返回 到 主 窗口 的 
lineText 文 本 框 控 件 中 。 

第 一 种 方法 : 直接 在 主 窗口 程序 中 实例 化 该 对 话 框 ， 然 后 调用 该 对 











话 框 的 函数 来 获取 返回 值 ， 根 据 对 话 框 的 返回 值 单 击 确认 按钮 还 是 取消 
按钮 来 进行 下 一 步 操作 。 同 理 ， 对 于 上 面 的 DateDialog， 主 窗口 程序 的 
代码 如 下 : 

def onButton1Click(self ): 

dialog=DateDialog(self) 

result=dialog.exec_() 

date=dialog.dateTime() 

self.lineEdit.setText( date.date().toString() ) 

dialog.destroy() 

第 二 种 方法 : 在 主 窗 口 程序 中 调用 子 窗口 的 静态 函数 ， 实 际 上 这 种 
方法 与 第 一 种 方法 是 一 样 的 ， 只 不 过 它 是 利用 静态 函数 的 特点 ， 在 子 窗 
口 的 静态 函数 中 创建 实例 化 对 象 。 

def onButton2Click(self ): 
date,time,result=DateDialog.getDateTime() 





self. lineEdit.setText( date.toString() ) 

if result==QDialog.Accepted : 
print(' 选 择 确 认 按 钮 " 

else : 


Print( 选 择 取 消 按钮 ) 


CINE: 








对 于 多 窗口 的 数据 传递 ， 一 般 是 通过 子 窗口 发 射 信号 的 ， 主 窗口 通 
过 槽 函数 捕获 这 个 信号 ， 然 后 获取 信和 号 里 面 的 数据 。 子 窗口 发 射 的 信号 
有 两 种 ， 其 中 一 种 是 发 射 PyQt 内 置 的 一 些 信号 ; 另 一 种 是 发 射 自 定义 的 
信号 。 这 两 种 方式 的 信号 与 槽 机 制 在 本 例 中 都 会 介绍 到 。 

发 射 目 定义 信号 的 好 处 是 ， 它 的 参数 类 型 可 以 目 定 义 。 比 如 发 射 一 











个 目 定 义 信 号 ， 它 的 参数 类 型 可 以 为 int、str、dict、list 等 ， 如 果 发 射 内 
置信 号 ， 则 只 能 是 特定 的 几 个 参数 。 下 面 看 具体 代码 。 

首先 ， 建 立 一 个 对 话 框 文件 DateDialog2.py， 保 存 路 径 为 
PyQt5/Chapter07/transParam/DateDialog2.py， 其 完整 代码 如 下 : 





from PyQt5.QtCore import * 
from PyQt5.QtGui import * 
from PyQt5.QtWidgets import * 


class DateDialog(QDialog): 
Signal OneParameter = pyqtSignal (str) 


def init _ (self, parent=None) : 
super (DateDialog, self). init (parent) 
self.setWindowTitle(' 子 窗口 : 用 来 发 射 信号 ') 


# 在 布局 中 添加 控件 
layout = QVBoxLayout (self) 


self.label = QLabel (self) 
self.1abel.setText(' 前 者 发 射 内 置信 号 \n 后 者 发 射 自 定义 信号 ') 


self.datetime inner = QDateTimeEdit (self) 
self.datetime inner.setCalendarPopup (True) 


self.datetime inner.setDateTime (QDateTime.currentDateTime () ) 


self.datetime emit = QDateTimeEdit (self) 
self.datetime emit.setCalendarPopup (True) 


self.datetime emit.setDateTime (QDateTime.currentDateTime() ) 


layout.addWidget (self.label) 
layout.addWidget (self.datetime_ inner) 
layout.addWidget (self.datetime emit) 


# 使 用 两 个 button (Ok 和 Cancel) 分 别 连接 accept () Fe reject () PBR 
buttons = QDialogButtonBox ( 
QDialogButtonBox.Ok | QDialogButtonBox.Cancel, 
Qt.Horizontal, self) 
buttons.accepted.connect (self.accept) 
buttons.rejected.connect (self.reject) 


layout .addWidget (buttons) 
self.datetime emit.dateTimeChanged.connect (self.emit signal) 
def emit signal (self): 


date str = self.datetime emit.dateTime() .toString () 


self.Signal_ OneParameter.emit (date str) 


新 建 一 个 调用 对 话 框 的 主 窗口 文件 ”CallDialogMainWin2.py， 保 存 


路 径 为 PyQt5/Chapter07/transParam/CallDialogMainWin2.py， 其 完整 代码 
如 下 : 


import sys 
from PyQt5.QtCore import * 
from PyQt5.QtGui import * 


from PyQt5.QtWidgets import * 


from DateDialog2 import DateDialog 


class WinForm(QWidget) : 


iE 


def init (self, parent=None) : 
super(WinForm, self). init (parent) 
self.resize(400, 90) 
self.setWindowTitle(' 信 号 与 楷 传 递 参 数 的 示例 ') 


self.open btn = QPushButton(' 获 取 时 间 ') 
self.lineEdit inner = QLineEdit (self) 
self.lineEdit emit = QLineEdit (self) 


self.open btn.clicked.connect (self.openDialog) 


self.lineEdit inner.setText(' 接 收 子 窗口 内 置信 号 的 时 间 ' ) 
self.lineEdit_emit.setText (' 接 收 子 窗口 自 定义 信号 的 时 间 " ) 


grid = QGridLayout () 
grid.addWidget (self.lineEdit inner) 
grid.addWidget (self.lineEdit emit) 


grid.addWidget (self.open btn) 
self.setLayout (grid) 


def openDialog(self): 
dialog = DateDialog(self) 
HRT ROMA RSSSER OM BK! 
dialog.datetime inner.dateTimeChanged.connect ( 
selt.deal inner islot) 
''! 连 接 子 窗口 的 自 定义 信号 与 主 窗口 的 楷 函 数 ''' 
dialog.Signal OneParameter.connect (self.deal emit slot) 


dialog.show() 


def deal inner slot (self, date) ; 
self.lineEdit_inner.setText (date.toString() ) 


def deal emit slot(self, dateStr) : 
self.lineEdit_emit.setText (dateStr) 


name == " main ": 





app = QApplication(sys.argv) 


form = WinForm() 


form. show () 


sys.exit(app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 7-35 和 图 7-36 所 示 。 
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图 7-35 
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图 7-36 


这 些 代码 的 逻辑 其 实 很 简单 ， 对 于 子 窗 口 ( 文 件 为 
PyQt5/Chapter07/transParam/DateDialog2.py) ， 关 键 是 如 何 实现 符合 特 
定 条 件 的 自 定 义 信号 的 发 射 问题 。 下 面 的 代码 表示 当 控 件 datetime_emit 
的 时 间 发 生变 化 时 ， 就 会 触发 子 窗 口 的 横 函 数 emit_signal， 而 在 这 个 槽 
函数 中 又 会 发 射 自 定义 信号 Signal_OneParameter， 这 个 信号 函数 是 为 了 
传递 date_str 参 数 给 主 函 数 的 槽 函数 。 











self.datetime_emit.dateTimeChanged.connect(self.emit_signal) 





def emit_signal(self): 
date_str=self.datetime_emit.dateTime().toString() 
self.Signal_OneParameter.emit(date_str) 
对 于 主 窗口 (文件 为 
PyQt5/ apero (Gans paren Cal ise Man Wie py) ， 关 键 是 获取 子 窗 
口 的 信号 ， 并 把 它 绑 定 在 自己 的 槽 冰 数 上 上， 这样 束 实现 了 子 窗口 的 控件 
与 主 窗口 的 控件 的 信号 与 槽 的 绑 定 。 下 面 的 代码 是 这 个 文件 的 关键 ， 展 
示 了 如 何 把 子 窗 口 的 内 置信 号 与 目 定 义 信和 号 绑 定 到 主 窗 口 的 槽 函数 。 
def openDialog(self): 
dialog=DateDialog(self) 
"ERT A OWA Bia So SE t Oe es 2" 


dialog.datetime_inner.dateTimeChanged.connect( 











self.deal_inner_slot) 


"连接 子 窗口 的 目 定 义 信 号 与 主 窗口 的 槽 函数 " 


dialog.Signal_OneParameter.connect(self.deal_emit_slot) 








dialog.show() 
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使 用 PyQt 实 现 的 窗口 样式 ， 默 认 使 用 的 就 是 当前 操作 系统 的 原生 窗 
口 样 式 。 在 不 同 操作 系统 下 原生 窗口 样式 的 显示 效果 是 不 一 样 的 ， 在 
Ubuntu 下 窗口 的 美化 效果 可 以 用 美观 来 形容 ， 而 在 Windows 下 就 不 那么 
美观 了 。 虽 然 应 用 程序 关心 的 是 业务 和 功能 ， 但 是 也 需要 实现 一 些 个 性 
化 的 界面 ， 如 QQ、 微 信和 360 SSN FA, MIRE. Mal, IF 
合用 户 的 使 用 习惯 。 总 而 言 之 ， 软 件 界面 的 设计 ， 直 接 决定 着 用 户 对 该 
软件 的 第 一 印象 ， 决 定 着 使 用 者 对 其 青睐 与 否 ， 所 以 我 们 需要 定制 窗口 
样式 ， 以 实现 统一 的 窗口 风格 和 美化 窗口 界面 。 














8.1 窗口 


8.1.1 设置 窗口 


(1) 可 以 为 每 个 Widget 都 设置 风格 。 
setStyle(QStyle style) 
(2) 获得 当前 平台 文 持 的 原 有 的 QStyle 样 式 。 
QStyleFactory.keys() 
(3) 对 QApplication 设 置 QStyle 样 式 。 
QApplication.setStyle(QStyleFactory.create("WindowsXP")) 
如 果 其 他 Widget 没 有 设置 QStyle， 则 默认 使 用 QApplication 设 置 的 
QStyle. 
案例 8-1 设置 窗口 风格 
本 例文 件 名 为 PyQt5/Chapter08/qt08_changeStyle.py， 演 示 设 置 窗 口 
风格 。 其 完整 代码 如 下 : 


import sys 

from PyOQt5.QtWidgets import * 
from PyQt5.QtCore import * 
from PyQt5 import QtCore 

from PyQt5.QtGui import * 


class AppWidget( QWidget) : 
def init (self, parent=None): 
super (AppWidget, self). init (parent) 
horizontalLayout = QHBoxLayout () 
self.styleLabel = QLabel ("Set Style:") 
self.styleComboBox = QComboBox () 
# 从 QStyleFactory 中 增加 多 个 显示 样式 
self.styleComboBox.addIitems( QStyleFactory.keys()) 
# 选择 当前 窗口 风格 
index = self.styleComboBox.findText( 
QApplication.style() .objectName(), 
QtCore.Qt.MatchFixedString) 
# 设置 当前 窗口 风格 
self.styleComboBox.setCurrentIndex (index) 
# 通过 ComboBox 控件 选择 窗口 风格 
self.styleComboBox.activated[str].connect 
(self. handleStyleChanged) 
horizontalLayout.addWidget (self.styleLabel) 
horizontalLayout.addWidget (self.styleComboBox) 
self.setLayout (horizontalLayout) 


# 改变 窗口 风格 
def handleStyleChanged(self, style): 
QApplication.setStyle (style) 


if name == " main "3 
app = QApplication(sys.argv) 
widgetApp = AppWidget () 
widgetApp. show () 


SYS.Cx1E(app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 8-1 所 示 。 





2 界面 风 ... 一 O 


Set Style: WindowsVista Y 





图 8-1 
8.1.2 设置 窗口 术 


PyQt 使 用 setWindowFlags(Qt.WindowFlags) 函 数 设 置 窗口 样式 ， 其 
具体 参数 如 下 。 
(1) PyQt 有 如 下 几 种 基本 的 窗口 类 型 。 
o QtWidget， 默 认 窗 口 ， 有 最 小 化 、 最 大 化 、 关 闭 按钮 。 
e Qt.Window， 普 通 窗 口 ， 有 最 小 化 、 最 大 化 、 关 闭 按钮 。 
e Qt.Dialog， 对 话 框 窗口 ， 有 问号 和 关闭 按钮 。 
o Qt.Popup， 弹 出 窗口 ， 窗 口 无 边框 。 
e Qt.ToolTip， 提 示 窗 口 ， 窗 口 无 边框 ， 无 任务 栏 。 
e Qt.SplashScreen， 闪 屏 ， 窗 口 无 边框 ， 无 任务 栏 。 
e Qt.SubWindow， 子 窗口 ， 窗 口 无 按钮 ， 但 有 标题 。 
(2) Ae QUE BAS MTs o 


























Qt .MSWindowsFixedSizeDialogHint # 窗 口 无 法 调整 大 小 


Qt .FramelessWindowHint # 窗 口 无 边框 

Qt .CustomizeWindowHint # 有 边框 但 无 标题 栏 和 按钮 ， 不 能 移动 和 拖 动 

Qt .WindowTitleHint # 添 加 标题 栏 和 一 个 关闭 按钮 

Qt.WindowSystemMenuHint # 添 加 系统 目录 和 一 个 关闭 按钮 

Ot.WindowMaximizeButtonHint # 激 活 最 大 化 和 关闭 按钮 ， 禁 止 最 小 化 按钮 

Qt .WindowMinimizeButtonHint # 激 活 最 小 化 和 关闭 按钮 ， 禁 止 最 大 化 按钮 

Qt .WindowMinMaxButtonsHint # 激 活 最 小 化 、 最 大 化 和 关闭 按钮 ， 相 当 于 
Qt.WindowMaximizeButtonHint| Qt.WindowMinimizeButtonHint 

Qt .WindowCloseButtonHint # 添 加 一 个 关闭 按钮 

Qt .WindowContextHelpButtonHint # 添 加 问号 和 关闭 按钮 ， 像 对 话 框 一 样 

Qt .WindowStaysOnTopHint # 窗 口 始 终 处 于 顶层 位 置 

Qt.WindowStaysOnBottomHint # 窗 口 始终 处 于 底层 位 置 


在 窗口 类 的 _ init_ 函数 中 使 用 self.setWindowFlags() 函 数 。 本 例文 
件 名 为 PyQt5/Chapter08/qt08_winStyle01.py， 演 示 设 置 窗口 样式 。 其 完 
整 代码 如 下 : 


from PyQt5.QtCore import Qt 


import sys 
from PyOt5.QtWidgets import QMainWindow , QApplication 


class MainWindow (QMainWindow) : 
def init  (self,parent=None): 
super (MainWindow,self). init (parent) 
self.resize(400, 200) 
self.setWindowTitle ("设置 窗口 样式 例子 ") 
# 设置 无 边框 窗口 样式 
self.setWindowFlags( Qt.FramelessWindowHint ) 


if name ==" main ": 
app = QApplication(sys.argv) 
win = MainWindow () 
win. show () 


sys.exit(app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 8-2 所 示 。 


J 


Python 


图 8-2 





在 上 面 的 代码 中 ， 使 用 主 窗口 类 的 setWindowFlags() 函 数 ， 设 置 无 
边框 窗口 样式 。 其 核心 代码 如 下 : 
# 设置 无 边框 窗口 样式 
self.setWindowFlags( Qt.Frameless WindowHint ) 





随 着 互联 网 的 发 展 ， 越 来 越 多 的 软件 在 初始 化 时 ， 采 用 在 用 户 的 显 
示 屏 幕 中 全 屏 展开 的 形式 。 在 接 下 来 的 例子 中 ， 我 们 将 开发 一 个 自 定义 
的 无 边框 窗口 ， 它 可 以 占用 100% 的 用 户 显示 屏幕 。 
(1) 设置 窗口 标志 ， 实 现 无 边框 效果 。 
# 设置 窗口 标志 【无 边框 ) 
self.setWindowFlags(QtCore.Qt.FramelessWindowHint) 
(2) fa tt ELE K K Lo 
首先 ， 应 得 到 屏幕 可 显示 尺寸 ， 需 要 用 到 QDeskWidget 类 的 
availableGeometry() A 20. 














# 得 到 更 面 控件 
desktop=QApplication.desktop() 
# fa PI BE ae AY ae aN ART 
rect=desktop.availableGeometry() 

然后 ， 设 置 窗 口 尺 寸 为 屏幕 可 显示 尺寸 并 显示 。 
# 设置 窗口 尺寸 
self.setGeometry(rect) 
# 显示 窗口 
self.show() 

本 例文 件 名 为 PyQt5/Chapter08/qt08_winStyle02.py， 演 示 使 用 自 定 

义 的 无 边框 窗口 。 其 完整 代码 如 下 : 








# 显示 窗口 


self.show() 


PE name == " main ": 
Tasa 
# 声 明 变 量 
app = QApplication(sys.argv) 
# 创建 窗口 


window = MyWindow() 

# 调用 最 大 化 显示 函数 
window. showMaximized () 
# 应 用 程序 事件 循环 


sys.exit(app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 8-3 所 示 。 





图 8-3 





8.2 2z B 


8.2.1 图 像 类 


在 PyQt 中 常用 的 图 像 类 有 4 个 ， 即 QPixmap、QImage、QPicture 和 
QBitmap. 

° QPixmap 是 专门 为 绘图 而 设计 的 ， 在 绘制 图 片 时 需要 使 用 
QPixmap. 

o QImage 提供 了 一 个 与 硬件 无 关 的 图 像 表示 图 数 ， 可 以 用 于 图 片 
的 像素 级 访问 。 

e QPicture 是 一 个 绘图 设备 类 ， 它 继承 和 目 QPainter 类 。 可 以 使 用 
QPainter 的 begin0) 函 数 在 QPicture 上 绘图 ， 使 用 end0 函 数 结束 绘图 ， 使 用 
QPicture 的 save0 函 数 将 QPainter 所 使 用 过 的 绘图 指令 保存 到 文件 中 。 

e QBitmap 是 一 个 继承 和 白 QPixmap 的 简单 类 ， 它 提供 了 1bit 深 度 的 二 
值 图 像 的 类 。QBitmap 提供 的 单 色 图 像 ， 可 以 用 来 制作 游标 

(QCursor) 或 者 笔 刷 (QBrush) 。 

图 像 类 的 继承 关系 如 图 8-4 所 示 。 





图 8-4 


8.2.2 简单 绘 





本 节 实 现 最 基本 的 画 线 功能 。 本 例文 件 名 为 
PyQt5/Chapter08/qt08_winDraw01.py， 其 完整 代码 如 下 : 


# 设置 画布 大 小 为 400*400， 背 景 为 白色 
self.pix = QPixmap(400, 400) 
self.pix.fill(Qt.white) 


#2 

def paintEvent (self,event): 
pp = QPainter( self.pix) 
# 根据 鼠标 指针 前 后 两 个 位 置 绘制 直线 
pp.drawLine( self.lastPoint, self.endPoint) 
# 让 前 一 个 坐标 值 等 于 后 一 个 坐标 值 ， 就 能 画 出 连续 的 线 
self.lastPoint = self.endPoint 
painter = QPainter(self) 


painter.drawPixmap(0, 0, self.pix) 


#3 
def mousePressEvent (self, event) 
+ 按 下 鼠标 左 键 
if event.button() == Qt.LeftButton 
self.lastPoint = event.pos() 
self.endPoint = self.lastPoint 
#4 
def mouseMoveEvent (self, event): 
# 然后 移动 鼠标 指针 
if event.buttons() and Qt.LeftButton 
self.endPoint = event.pos() 
# 进行 重新 绘制 
self.update () 


#5 
def mouseReleaseEvent( self, event): 
+ 释放 鼠标 左 键 
if event.button() == Qt.LeftButton 
self.endPoint = event.pos() 
# 进行 重新 绘制 
self.update () 
if name == " main ": 


app = QApplication(sys.argv) 
form = Winform() 
form.show () 


sys.exit (app.exec_ ()) 


运行 脚本 ， 显 示 效 果 如 图 8-5 所 示 。 
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代码 分 析 : 

在 这 个 例子 中 ， 实 现 了 简单 的 绘图 功能 ， 按 住 鼠 标 左 键 在 画板 上 进 
行 绘 国 ， 释 放 鼠 标 左 键 结 束 绘画 。 

第 1 组 代码 : 初始 化 代码 。 

第 2 组 代码 : 重 构 paintEventO 函 数 。 

第 3 组 代码 : 重 构 。” ”mousePressEvent() 函 数 ， 使 用 两 个 点 来 绘制 线 








条 ， 这 两 个 点 从 下 面 的 鼠标 事件 中 获取 。 

第 4 组 代码 : 重 构 mouseMoveEvent() 函 数 ， 当 鼠标 左 键 按 下 时 获得 
开始 点 ， 每 次 绘制 都 让 结束 点 和 开始 点 重合 ， 这 样 确保 这 两 个 点 的 值 都 
是 预期 的 值 。 

第 5 组 代码 : E ” mouseReleaseEvent( 函 数 ， 当 鼠标 指针 移动 时 获 
得 结束 点 ， 并 更 新 绘制 。 注 意 ， 这 里 的 buttons0) 函 数 可 以 获取 在 鼠标 指 
针 移 动 过 程 中 按 下 的 所 有 按键 ， 然 后 用 Qt.LeftButton 来 判断 是 否 按 下 了 
左 键 。 在 mouseMoveEvent() 中 必须 使 用 该 函数 来 判断 按 下 的 鼠标 按键。 
最 后 调用 update0 函 数 ， 会 执行 paintEvent() 函 数 进 行 重新 绘制 。 

当 释 放 鼠 标 按键 时 也 会 进行 重 绘 。 现 在 运行 程序 ， 按 下 鼠标 左 键 在 
白色 画布 上 进行 绘制 ， 实 现 了 简单 的 涂鸦 板 功 能 。 











8.2.3 双 绥 冲 绘 


本 节 讲 解 在 画板 上 绘制 矩形 ， 还 会 讲解 双 缓 冲 绘图 的 概念 。 
案例 8-2 绘制 矩形 ， 出 现 重 影 
本 例文 件 名 为 PyQt5/Chapter08/qt08_winDraw02.py， 演 示 绘 制 矩形 
的 功能 。 其 完整 代码 如 下 : 





运行 脚本 ， 显 示 效 果 如 图 8-6 所 示 。 





代码 分 析 : 
在 这 个 例子 中 ， 首 先 将 图 形 绘 制 在 画布 上 ， 然 后 将 画布 绘制 到 窗口 


中 。 
第 1 组 代码 : 重 构 painEventO 函 数 ， 在 函数 中 添加 初始 化 代码 ， 就 
是 通过 lastPoint 和 endPoint 两 个 点 来 确定 所 要 绘制 的 矩形 的 起 点 、 宽 度 和 





高 度 。 
运行 程序 ， 使 用 鼠标 拖 出 一 个 和 矩形， 发现 出 现 了 很 多 重 影 。 为 什么 
会 有 重 影 呢 ? 





可 以 尝试 分 别 快速 和 慢 速 拖 动 鼠标 来 绘制 矩形 ， 结 果 发 现 ， 拖 动 速 
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次 ， 也 可 以 理解 为 paintEvent() 函 数 执行 了 多 次 ， 每 执行 一 次 就 会 绘制 一 
个 矩形 。 知 道 了 原因 ， 就 可 以 想 办 法 来 避免 出 现 重 影 了 。 

案例 8-3 组 T2] Bape 现 重 影 








本 例文 件 名 为 PyQt5/Chapter08/qt08_winDraw03.py， 演 示 使 用 双 组 
冲 技术 绘制 矩形 ， 避 免 出 现 重 影 。 其 完整 代码 如 下 : 


运行 脚本 ， 显 示 效 果 如 图 8-7 所 示 。 


Ce x 





代码 分 析 : 

在 这 个 例子 中 ， 按 下 鼠标 左 键 时 标志 正在 绘图 ， 当 释放 鼠标 左 键 时 
则 取消 正在 绘图 的 标志 。 运 行程 序 ， 绘 图 正常 ， 没 有 重 影 。 

在 这 个 例子 中 ， 需 要 添加 一 个 辅助 画布 ， 如 果 正 在 绘图 ， 也 就 是 还 
没有 释放 鼠标 左 键 时 ， 就 在 这 个 辅助 画布 上 进行 ， 只 有 释放 鼠标 左 键 
时 ， 才 在 真正 的 画布 上 绘图 。 

第 1 组 代码 : 添加 两 个 变量 。 


# 辅助 画布 
self.tempPix=QPixmap() 
# braze IETER AI 
self.isDrawing=False 
第 2 组 代码 : 重 构 painEvent(0) 函 数 ， 如 果 正 在 绘图 ， 束 在 辅助 画布 
上 进行 ， 将 以 前 pix 中 的 内 容 复 制 到 tempPix 中 ， 保 证 以 前 的 内 容 不 消 
Fes 
第 3 组 代码 : 重 构 mousePressEvent() 了 水 数 ， 更 改 鼠 标 按键 按 下 时 处 
理 函 数 的 内 容 。 
第 4 组 代码 : 重 构 ”mouseReleaseEvent() 函 数 ， 更 改 鼠 标 按键 释放 时 
处 理 函 数 的 内 容 。 
双 缓 冲 技术 总 结 : 
在 这 个 例子 中 ， 要 实现 使 用 鼠标 在 界面 上 绘制 一 个 任意 大 小 的 矩形 
而 不 出 现 重 影 ， 需 要 两 个 画布 ， 它 们 都 是 QPixmap 实 例 ， 其 中 tempPix 作 
为 临时 缓冲 区 ， 当 拖 动 鼠标 绘制 矩形 时 ， 将 内 容 先 绘制 到 tempPix 上 ， 
然后 再 将 tempPix 绘 制 到 界面 上 ; pix 作 为 缓冲 区 ， 用 来 保存 已 经 完成 的 
绘制 。 当 释放 鼠标 按键 完成 矩形 的 绘制 后 ， 则 将 tempPix 的 内 容 复 制 到 
pi 上 。 为 了 在 绘制 时 不 出 现 重 影 ， 而 且 保 证 以 前 绘制 的 内 容 不 消失 ， 
那么 每 一 次 绘制 都 是 在 原来 的 图 形 上 进行 的 ， 所 以 需要 在 绘制 tempPix 
之 前 ， 先 将 pix 的 内 容 复 制 到 tempPix 上。 因为 这 里 有 两 个 QPixmap 对 
象 ， 也 可 以 说 有 两 个 缓冲 区 ， 所 以 称 之 为 “ 双 绥 冲 绘 图 ”。 














8.3 QSS 的 UI 美 化 


QSS (Qt Style Sheets) 即 Qt 样 式 表 ， 是 用 来 自 定义 控件 外 观 的 一 种 
机 制 。QSS 大 量 参考 了 CSS 的 内 容 ， 但 QSS 的 功能 比 CSS 要 弱 得 多 ， 体 
现 为 选择 器 少 ， 可 以 使 用 的 QSS 属性 也 少 ， 并 且 并 不 是 所 有 的 属性 都 
可 以 应 用 在 ”PyQt ”的 控件 上 。QSS 使 页 面 美化 跟 代码 层 分 开 ， 利 于 维 
Te 








8.3.1QSS 的 语法 规 见 


QSS 的 语法 规则 几乎 与 CSS 相 同 。QSS 样 式 由 两 部 分 组 成 ， 其 中 一 
部 分 是 选择 器 (Selector) ， 指 定 哪些 控件 会 受到 影响 ， 另 一 部 分 是 
HH (Declaration) ， 指 定 哪 些 属 性 应 该 在 控件 上 进行 设置 。 声 明 部 分 是 
一 系列 的 “属性 : 值 ? 对 ， 使 用 分 号 G) 分 隔 各 个 不 同 的 属性 值 对 ， 使 用 
KES HUP 将 所 有 的 声明 包括 在 内 。 例 如 : 
QPushButton {color:red} 

表示 设置 QPushButton 类 及 其 子 类 的 所 有 实例 的 前 景色 是 红色 。 其 
中 ，QPushButton 表 示 选 择 器 ， 指 定 所 有 的 QPushButton 类 及 其 子 类 都 
会 受到 影响 。 注 意 ， 凡 是 继承 自 QPushButton 的 子 类 都 会 受到 影响 ， 这 
是 与 CSS 不 同 的 地 方 ， 因 为 CSS 应 用 的 都 是 一 些 标签 ， 没有 类 的 层次 结 
构 ， 更 没有 子 类 的 概念 。{color:red} 则 是 规则 的 定义 ， 表 示 指 定 前 景 
是 红色 。 本 例文 件 名 为 PyQt5/Chapter08/qt08_qssStyle01.py， 其 完整 代码 
如 下 : 

















运行 脚本 ， 显 示 效 果 如 图 8-8 所 示 。 





代码 分 析 : 
在 这 个 例子 中 ， 整 个 窗口 加 载 了 上 自 定 义 的 QSS 样 式 ， 窗 口中 按钮 的 
背景 色 都 为 红色 。 
首先 定义 了 QSS 样式 ， 然 后 使 用 win.setStyleSheetO 函 数 加 载 QSS 
样式 ， 该 函数 可 以 对 整个 窗口 进行 样式 设置 ，setStyleSheet() 函 数 本 映 是 
QWidget 的 成 员 函 数 ，PyQt 中 的 大 多 数控 件 都 可 以 直接 通过 该 函数 来 设 
置 样 式 。 
还 可 以 使 用 多 个 选择 器 指定 相关 的 声明 ， 使 用 过 写 将 各 个 选择 器 分 
离 ， 例 如 : 
QPushButton,QLineEdit,QComboBox { color: blue } 
CHAT: 
QPushButton { color: red } 
QLinekdit { color: red } 
QComboBox { color: red } 


8.3.2 QSS 选 择 器 类 型 


QSS 选 择 器 有 如 下 几 种 类 型 。 

(1) 通 配 选择 器 : *， 匹 配 所 有 的 控件 。 

(2) 类 型 选择 器 : QPushButton， 匹 配 所 有 的 QPushButton 类 及 其 
子 类 的 实例 。 


(3) 属性 选择 器 : QPushButton[name="myBtn"]， 匹 配 所 有 的 name 
属性 是 myBtn 的 QPushButton 实例 。 注 意 ， 该 属性 可 以 是 自 定 义 的 ， 不 
一 定 非 得 是 类 本 身 具 有 的 属性 。 

本 例文 件 名 为 PyQt5/Chapter08/qt08_qssStyle02.py， 对 
qt08_qssStyle01.py 做 了 一 些 修改 ， 给 按钮 btn2 设 置 了 属性 名 。 其 核心 代 
码 如 下 : 

btn2=QPushButton(self ) 
btn2.setProperty( 'name' ,myBtn ) 
btn2.setText(' 按 钮 2") 

然后 将 所 使 用 的 QSS 修 改 为 属性 名 为 myBtn 的 QPushButton， 改 变 背 

景 颜色 。 


win=WindowDemo() 








qssStyle="" 
QPushButton[name="myBtn"]{ 


background-color: red 


WY 


win.setStyleSheet( qssStyle ) 
win.show() 
运行 脚本 ， 显 示 效 果 如 图 8-9 所 示 ， 可 以 看 到 只 有 “按钮 2”* 的 背景 闫 
BCE T BB 





(4) 类 选择 器 : .QPushButton， 匹 配 所 有 的 QPushButton 实 例 ， 但 
是 并 不 匹配 其 子 类 。 注 意 前 面 有 一 个 点 号 ， 这 是 与 CSS 中 的 类 选择 器 不 
一 样 的 地 方 。 
(5) ID 选择 器 : #myButton， 匹 配 所 有 的 为 myButton 的 控件 ， 这 
里 的 ID 实际 上 就 是 objectName 指 定 的 值 。 
(6) 后 代 选 择 器 : QDialog QPushButton, VLAKY QDialog 容 
器 中 包含 的 QPushButton， 不 管 是 直接 的 还 是 间接 的 。 
(7) 子 选 择 器 : QDialog>QPushButton, ILMAR QDialog 容 
器 中 包含 的 QPushButton， 其 中 要 求 QPushButton 的 直接 父 容器 是 
QDialog. 
另外 ， 上 面 所 有 的 选择 器 可 以 联合 使 用 ， 并 且 文 持 一 次 设置 多 种 选 
择 器 类 型 ， 用 过 号 隔 开 。 例 如 #frameCnut#frameInterrupt#frameJoin， 表 
示 这 些 ID 使 用 一 个 规则 ; #mytable = QPushButton， 表 示 选 择 所 有 ID 为 
mytable 的 容器 中 包含 的 QPushButton 控 件 。 











8.3.3 QSS 子 控件 


QSS 子 控件 实际 上 也 是 一 种 选择 器 ， 其 应 用 在 一 些 复合 控件 上 ， 典 
型 的 如 QComboBox， 该 控件 的 外 观 是 ， 有 一 个 矩形 的 外 边框 ， 右 边 有 
一 个 下 拉 箭 头 ， 点 击 之 后 会 弹出 下 拉 列 表 。 例 如 : 


QComboBox::drop-down { image: url(dropdown.png) } 
上 面 的 样式 指定 所 有 QComboBox 的 下 拉 箭 头 的 图 片 是 自 定义 的 ， 
图 片 文件 为 dropdown.png。 
::drop-down 子 控件 选择 器 可 以 与 上 面 提 到 的 选择 器 联合 使 用 。 例 
如 : 
QComboBox#myQComboBox::drop-down { image: 
url(dropdown.png) } 
表示 为 指定 ID 为 myQComboBox 的 QComboBox 控 件 的 下 拉 箭 头 自 定 
义 图 乒 。 需 要 注意 的 是 ， 子 控件 选择 需 实 际 上 是 选择 复合 控件 的 一 部 
分 ， 也 就 是 对 复合 控件 的 一 部 分 应 用 样式 ， 例 如 为 QComboBox 的 下 拉 
第 头 指定 图 片 ， 而 不 是 为 QComboBox 本 身 指定 图 片 。 
本 例文 件 名 为 PyQt5/Chapter08/qt08_qssStyle03.py， 其 完整 代码 如 
Rs 








from PyQt5.QtWidgets import * 
import sys 


class WindowDemo (QWidget) : 
def init (self): 
super (WindowDemo, self). init (J; 
self.InitUI(); 


def InitUI (self): 
combo = QComboBox (self) 
combo.setObjectName ('myQComboBox') 
combo.addItem('Window' ) 
combo.addItem('Ubuntu') 


combo.addItem('Red Hat") 

combo.move (50,50) 

self.setGeometry (250,200, 320,150) 
self.setWindowTitle ('QComboBox 样式 ') 


if name == " main ™: 
app = QApplication(sys.argv) 
win = WindowDemo () 
# 定义 QComboBox 控件 的 OSS 样式 
qssStyle = '''! 
QComboBox#myQComboBox::drop-down { 
image: url( ./images/dropdown.png) 


} 


win.setStyleSheet( qssStyle ) 
win. show () 
sys.exit(app.exec_ ()) 


运行 脚本 ， 显 示 效 果 如 图 8-10 所 示 。 
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图 8-10 


8.3.4 QSS 仿 状态 





QSS 伪 状态 选择 器 是 以 冒号 开头 的 一 个 选择 表达 陈 ， 例 如 :hover， 
表示 当 鼠 标 指 针 经 过 时 的 状态 。 伪 状态 选择 器 限制 了 当 控 件 处 于 茶 种 状 
态 时 才 可 以 使 用 QSS 规 则 ， 伪 状态 只 能 描述 一 个 控件 或 者 一 个 复合 控件 


的 子 控 件 的 状态 ， 所 以 它 只 能 放 在 选择 器 的 最 后 面 。 例 如 : 
QComboBox:hover{background-color:red;} 
表示 当 鼠 标 指针 经 过 QComboBox 时 ， 其 背景 色 指 定 为 红色 ， 该 伪 
状态 :hover 描 述 的 是 QComboBox 的 状态 。 除 可 以 描述 选择 器 所 选择 的 
控件 外 ， 伪 状态 还 可 以 描述 子 控件 选择 器 所 选择 的 复合 控件 的 子 控件 的 
状态 。 例 如 : 
QComboBox::drop-down:hover{background-color:red;} 
表示 当 鼠 标 指针 经 过 QComboBox 的 下 拉 箭 头 时 ， 该 下 拉 箭 头 的 背 
景色 变 成 红色 。 
此 外 ， 伪 状态 还 可 以 用 一 个 感叹 号 来 表示 状态 ， 例 如 :hover WR 
标 指针 经 过 的 状态 ， 而 :Ihover 表 示 鼠 标 指针 没有 经 过 的 状态 。 多 种 伪 状 
态 可 以 同时 使 用 ， 例 如 : 
QCheckBox:hover:checked { color: white } 
表示 当 鼠 标 指针 经 过 一 个 选中 的 QCheckBox 时 ， 设 置 其 文字 的 前 景 
色 为 白色 。 
QSS 提供 了 很 多 伪 状 态 ， 一 些 盆 状态 只 能 用 在 特定 的 控件 上 上， 具体 
有 哪些 伪 状 态 ， 在 PyQt 的 帮助 文档 中 有 详细 的 列表 。 





8.3.5 QDarkStyleSheet 


除 自己 编写 QSS 样式 表 外 ， 网 上 还 有 很 多 质量 很 高 的 QSS 样式 
表 ， 比 如 QDarkStyleSheet， 它 是 一 个 用 于 PyQt 应 用 程序 的 深 黑色 样式 
表 。 可 以 从 GitHub 上 下 载 ， 地 址 是 : 
https://github.com/ColinDuquesnoy/QDarkStyleSheet/tree/master/qdarks 
如 图 8-11 所 示 ， 可 以 看 到 QDarkStyleSheet 的 评 星 是 387， 还 是 很 高 
的 。 











ColinDuquesnoy / QDarkStyleSheet Owatch~ 41 Wstar 387 York 148 





<> Code Issues 0 Pull requests 0 Projects 0 


1.223 QDarkStyleSheet 

第 一 种 方法 : 单 击 右 侧 的 “Clone or download” 42411, 4% 
QDarkStyleSheet 下 载 到 本 地 ， 保 存在 PyQt5\Chapter08\QDarkStyleSheet- 
master 目 录 下 ， 如 图 8-12 所 示 。 


A dark style sheet for Qt application 


® 228 commit p 1 branch © 16 release 48 13 contributors 中 MIT 


master ~ New pull request Create new file Upload files Find file Clone or download ~ 
Jum t n to 2.3.1 e SSH 


Clone with HTTPS © 
Use Git or checkout with SVN using the web URL. 





https: //github.com/ColinDuquesnoy/QDarkStyl: ff 


e mprove yrs (use accent y 
Ba qdarkstyle Bump version to 2.3.1 : 
screenshots date screensho à 
eres eal ‘ Open in Desktop Download ZIP 
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图 8-12 


第 二 种 方法 : 使 用 pip 命 令 安装 。 
pip install qdarkstyle 

2.4 H QDarkStyleSheet 

首先 ， 需 要 导入 qdarkstyle 模 块 。 
import qdarkstyle 

然后 ， 使 用 app.StyleSheet() 加 载 qdarkStyle 的 样式 表 。 
app.setStyleSheet(qdarkstyle.load_stylesheet_pyqt5()) 

AS Bil SCE AZ AY Py Qt5/Chapter08/QDarkStyleSheet-master/example/ 

example_pyqt5.py， 其 完整 代码 如 下 : 





运行 脚本 ， 显 示 效 果 如 图 8-13 所 示 。 
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8.4 设置 窗口 背景 





窗口 背景 主要 包括 : 背景 色 和 背景 图 片 。 设 置 窗口 背景 主要 有 三 种 
Th es 

o 使 用 QSS 设 置 窗口 背景 。 

o 使 用 QPalette 设 置 窗口 背景 。 

e 实现 paintEvent， 使 用 QPainter 绘 制 背景 


8.4.1 SS 设置 窗口 背景 


在 QSS 中 ， 我 们 可 以 使 用 background 或 者 background-color 的 方式 来 
设置 背景 色 。 设 置 窗口 背景 色 之 后 ， 子 控件 默认 会 继承 父 窗口 的 背景 
色 。 如 果 想 要 为 控件 设置 背景 图 片 或 图 标 ， 则 可 以 使 用 setPixmap 或 者 
setIcon 来 完成 。 关 于 这 两 个 函数 的 用 法 可 以 参考 第 4 章 中 的 案例 4-7 和 和 案 
例 4-14。 

1. 使 用 setStyleSheet0 设 置 窗口 背景 图 片 

假设 窗口 名 为 MainWindow， 使 用 setstyleSheet() 来 添加 背景 图 片 。 
本 例文 件 名 为 PyQt5/Chapter08/qt08_winBkground01.py， 其 核心 代码 如 
F: 











win=QMainWindow() 

# 设置 窗口 名 

win.setObjectName("MainWindow") 

# 设置 图 片 的 相对 路 径 

win.setStyleSheet("#MainWindow {border- 
image:url(images/python.jpg); }") 


还 可 以 通过 以 下 代码 ， 设 置 图 片 的 绝对 路 径 。 

win.setStyleSheet("#MainWindow{border- 
image:url(e:/images/python.jpg);}") 

运行 脚本 ， 显 示 效 果 如 图 8-14 所 示 。 


Python 





图 8-14 


2. 使 用 setStyleSheet(0 设 置 窗 口 背景 
win=QMainWindow() 
# 设置 窗口 名 
win.setObjectName("MainWindow") 


win.setStyleSheet("#MainWindow({background-color: yellow }") 
运行 脚本 ， 显 示 效 果 如 图 8-15 所 示 。 


图 8-15 








8.4.2 Palette 设 置 窗 口 背景 


1. 使 用 QPalette〈 调 色 板 ) 设置 窗口 背景 
本 例文 件 名 为 PyQt5/Chapter08/qt08_winBkground03.py， 其 核心 代 
码 如 下 : 
win=QMainWindow() 
palette=QPalette() 
palette.setColor(QPalette.Background ,Qt.red ) 
win.setPalette(palette) 
2. 使 用 QPalette 设 置 窗口 背景 图 片 
当 使 用 QPalette KAA RAN, PASE RAHAT, 55 
ae ER] Fr AY bis EP REAP at AY BE Ae BE, A A oR eS 
背景 ; 当 背 景 图 片 的 宽度 和 高 度 小 于 窗口 的 宽度 和 高 上 度 时 ， 则 会 加 载 多 
个 背景 图 片 。 使 用 的 图 片 素材 为 python.jpg， 效 果 如 图 8-16 所 示 。 





























图 8-16 


还 需要 查看 图 片 的 分 辨 率 ， 用 鼠标 右键 单 击 图 片 文 件 ， 从 弹出 的 快 
捷 菜 单 中 选择 “属性 ”， 在 打开 的 窗口 中 选择 “详细 信息 ”， 可 以 看 到 图 片 
的 分 辩 率 为 478 x260， 表 示 宽 度 为 478 像 素 ， 高 度 为 260 像 素 ， 如 图 8-17 
所 示 。 





478 x 260 
478 像素 
260 像素 
96 dpi 

96 dpi 
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图 8-17 








d) 当 背 景 图 片 的 宽度 和 高 度 大 于 窗口 的 宽度 和 高 度 时 ， 使 用 
setPaletteO 琴 加 背景 图 片 。 本 例文 件 名 为 
PyQt5/Chapter08/qt08_winBkground02.py， 其 核心 代码 如 下 : 

win=QMainWindow() 


palette=QPalette() 
palette.setBrush(QPalette.Background,QBrush(QPixmap("./images/py 
win.setPalette(palette) 
win.resize(460,255 ) 

运行 脚本 ， 显 示 效 果 如 图 8-18 所 示 。 





图 8-18 








(2) 当 背 景 图 片 的 宽度 和 高 度 小 于 窗口 的 宽度 和 高 度 时 ， 其 核心 
代码 如 下 : 

palette=QPalette() 

palette.setBrush(QPalette.Background,QBrush(QPixmap("./images/py 

win.setPalette(palette) 

win.resize(800,600 ) 

运行 脚本 ， 显 示 效 果 如 图 8-19 所 示 。 





图 8-19 


1. 使 用 paintEvent 设 置 窗口 背景 色 
本 例文 件 名 为 PyQt5/Chapter08/gt08_winBkground04.py， 其 核心 代 
码 如 下 : 
class Winform(QWidget): 
def __init__(self,parent=None): 
super(Winform, self). init__(parent) 
self.setWindowTitle("paintE venti E Ff xE") 


def paintEvent(self,event): 


painter=QPainter(self) 

painter.setBrush(Qt.black ); 

# 设置 背景 

painter.drawRect( self.rect()); 
运行 脚本 ， 显 示 效 果 如 图 8-20 所 示 。 


图 8-20 








2. 使 用 paintEvent 设 置 窗口 背景 图 片 


本 例文 件 名 为 PyQt5/Chapter08/qt08_winBkground05.py， 其 核心 代 


码 如 下 : 
class Winform(QWidget): 
def _init (self,parent=None): 


super(Winform, self). init (parent) 


self.setWindowTitle("paintEvent 设 置 背景 图 片 ") 
def paintEvent(self,event): 
painter=QPainter(self) 
pixmap=QPixmap("./images/screen1.jpg") 
# 设 置 窗口 背景 图 片 ， 平 铺 到 整个 窗口 ， 随 着 窗口 的 改变 而 
peas 
painter.drawPixmap(self.rect(),pixmap) 
运行 脚本 ， 显 示 效 果 如 图 8-21 所 示 。 








a, mo ; 
ETE ee 


` Pe iE 
ee Kh Ve ae 
. =e yA 
` $ ê 7 . . 
ATT A a w’ a 4 
A AN 





图 8-21 


8.5 个 规则 窗口 的 显示 


QWidget 类 中 比较 重要 的 绘图 函数 如 表 8-1 所 示 。 
表 8-1 


setMask(self, QBitmap) setMask() 的 作用 是 为 调用 它 的 控件 增加 一 个 谈 畦 ， 谈 住所 选区 域 以 外 的 
setMask(self, QRegion) 部 分 , 使 之 看 起 来 是 透明 的 。 它 的 参数 可 以 为 QBitmap 或 QRegion WE, 


此 处 调用 QPixmap 的 mask0O 函 数 获得 图 片 自身 的 遮 单 ， 是 一 个 QBitmap 
对 象 。 在 示例 中 使 用 的 是 PNG 格式 的 图 片 ， 它 的 透明 部 分 实际 上 就 是 一 


个 Fae 











paintEvent(self, QPaintEvent) 通过 重 载 paintEvent0 函 数 绘 制 窗 


ee 
db Æ, 


背景 图 片 ， 通 过 重 载 paintEvent() 函 数 绘制 窗口 背景 。 在 下 面 的 例子 中 ， 
使 用 如 图 8-22 所 示 的 图 片 素材 来 绘制 窗口 背景 。 











图 8-22 


本 例文 件 名 为 PyQt5/Chapter08/qt08_paint01.py， 其 完整 代码 如 下 : 


import sys 
from PyOQt5.QtWidgets import QApplication ,QWidget 
from PyQt5.QtGui import QPixmap, QPainter , QBitmap 


class MyForm(QWidget) : 
det T aomit (serf parent —None): 
super (MyForm,self). init (parent) 


self.setWindowTitle ("不 规则 窗口 的 实现 例子 ") 


def paintEvent (self,event): 
painter = QPainter (self) 
painter.drawPixmap (0,0,280,390,QPixmap (r"./images/dog.jpg") ) 
painter.drawPixmap (300,0,280,390,Qbitmap 
(c"./images/dog.jpg") ) 


am salle eae 
app = QApplication(sys.argv) 
form = MyForm() 
form. show () 


SVoeeuleaposexee NIH 


运行 脚本 ， 显 示 效 果 如 图 8-23 所 示 。 





图 8-23 


(2) 使 用 一 张 遮 单 层 图 片 来 控制 窗口 的 大 小 ， 然 后 再 利用 
paintEventO 函 数 重 绘 窗口 的 背景 图 等 。 本 例 使 用 的 素材 图 片 为 mask.png 


和 screen1.jpg， 效 果 如 图 8-24 和 图 8-25 所 示 。 





图 8-24 


图 8-25 


本 例文 件 名 为 PyQt5/Chapter08/qt08_paint02.py， 其 完整 代码 如 下 : 


import sys 
from PyQt5.QtWidgets import QApplication ,QWidget 
from PyQt5.QtGui import QPixmap, QPainter , QBitmap 


class Winform(QWidget) : 
def _ Imit (self, parenc=None) : 
super (Winform,self). init (parent) 
self.setWindowTitle ("不 规则 窗口 的 实现 例子 ") 


self.pix = QBitmap("./images/mask.png") 
self.resize(self.pix.size()) 


self.setMask (self.pix) 


def paintEvent (self,event) : 
painter = QPainter (self) 
# 在 指定 区 域 直 接 绘制 窗口 背景 
painter.drawPixmap (0,0,self.pix.width(),self.pix.height(), 
QPixmap("./images/screenl.jpg") ) 


if osname == "_ main ": 
app = QApplication(sys.argv) 
form = Winform() 
form. show () 


sys.exit(app.exec ()) 


(3) 实现 可 以 拖 动 的 不 规则 窗口 。 本 例文 件 名 为 
PyQt5/Chapter08/qt08_paint03.py， 其 完整 代码 如 下 : 


Qt.ThresholdDither | Qt.ThresholdAlphaDither) 
self.resize(self.pix.size()) 
self.setMask(self.pix.mask() ) 
self.dragPosition=None 


# HLA AMERE FD HH mousePressEvent (QMouseEvent) 和 鼠标 指针 移动 响 
应 函数 mouseMoveEvent (QMouseEvent) ， 使 不 规则 窗口 能 响应 息 标 事件 ， 随 意 拖 动 窗口 
def mousePressEvent (self, event): 
if event.button() == Qt.LeftButton: 
self.m_drag=True 
self.m DragPosition=event.globalPos()-self.pos() 
event.accept () 


self.setCursor (QCursor (Qt.OpenHandCursor) ) 


def mouseMoveEvent (self, QMouseEvent) : 
if Qt.LeftButton and self.m drag: 
# 当 使 用 左 键 移动 窗口 时 修改 偏 移 值 
self.move (QMouseEvent.globalPos()- self.m DragPosition ) 


QMouseEvent.accept () 


def mouseReleaseEvent (self, QMouseEvent) : 
self.m drag=False 


self.setCursor (QCursor (Qt.ArrowCursor) ) 


# 在 窗口 中 首次 绘制 时 ， 会 加 载 paintEvent () 函数 
def paintEvent (self, event): 
painter = QPainter (self) 
painter.drawPixmap(0, 0, 
self.pix.width(), 
self.pix.height(), 
self.pix ) 


# 鼠标 双击 事件 
def mouseDoubleClickEvent (self, event): 


self.mypix () 


Lf 2 fame == N main i 
app = QApplication(sys.argv) 
form = ShapeWidget () 
form.show () 


sys.exit(app.exec ()) 














还 可 以 使 用 PyQt 设 计 不 规则 窗口 的 动画 效 末 。 在 显示 不 规则 图 片 时 
主要 注意 如 下 两 点 。 
(1) pixmap.setMask0O 函 数 的 作用 是 为 调用 它 的 控件 增加 一 个 遮 
尝 ， 遮 住所 选区 域 以 外 的 部 分 ， 使 控件 看 起 来 是 透明 的 。 它 的 参数 可 以 
是 一 个 QBitmap 对 象 或 一 个 QRegion 对 象 。 本 例 中 调用 QPixmap 实 例 的 
self.pix.mask() 函 数 获 得 图 片 自身 的 遮 日 ， 这 个 庶 蛙 是 一 个 QBitmap 对 象 
self.pix=QPixmap(self.mypic ,"0"",Qt.AvoidDither | 
Qt.ThresholdDither| Qt.ThresholdAlphaDither) 
self.setMask(self.pix.mask()) 
(2) paintEvent() 函 数 每 次 初始 化 窗口 时 只 调用 一 次 ， 所 以 每 加 载 
一 次 图 片 就 要 重新 调用 一 次 paintEvent() 函 数 ， 即 在 更 新 窗口 时 调用 这 个 
函数 。 更 新 窗口 的 核心 代码 如 下 : 


self.timer=QTimer() 








self.timer.setInterval(500) 
self.timer.timeout.connect(self.timeChange) 
self.timer.start() 
当 定 时 器 Ctimer) 的 时 间 到 期 后 更 新 窗口 代码 。 
self.update() 
本 例文 件 名 为 PyQt5/Chapter08/qt08_paint04.py， 其 完整 代码 如 下 : 


self.update() 
if self.i == 5: 
self.i = 1 

self.mypic = {1: './images/left.png', 2: "./images/up.png", 3: 
',/images/right.png', 4: './images/down.png'} 

self.pix = QPixmap(self.mypic[self.i], "0", Qt.AvoidDither | 
Qt.ThresholdDither | Qt.ThresholdAlphaDither) 

self.resize(self.pix.size()) 


self.setMask(self.pix.mask() ) 





self.dragPosition = None 


def mousePressEvent (self, event): 
if event.button() == Ot.LeftButton: 
self.m_drag=True 
self.m_DragPosition=event.globalPos ()-self.pos() 
event.accept () 


self.setCursor (QCursor (Qt.OpenHandCursor) ) 


def mouseMoveEvent (self, QMouseEvent): 
if Qt.LeftButton and self.m drag: 
self.move (QMouseEvent.globalPos()- self.m DragPosition ) 
QMouseEvent.accept () 


def mouseReleaseEvent (self, QMouseEvent): 
self.m_drag=False 


self.setCursor (QCursor(Qt.ArrowCursor) ) 


def paintEvent (self, event): 
painter = QPainter(self) 
painter.drawPixmap(0, 0, 


self.pix.width(),self.pix.height(),self.pix) 


# 鼠标 双击 事件 
def mouseDoubleClickEvent (self, event): 
if event.button() == 
self.i += 1 


self.mypix () 


# 4500 毫秒 窗口 执行 一 次 更 新 操作 ， 重 绘 窗口 
def timeChange (self): 
self.i += 1 


self.mypix() 


if name == " main": 
app = QApplication(sys.argv) 
form = ShapeWidget () 
form. show () 


sys.exit(app.exec ()) 


运行 脚本 ， 显 示 效 果 如 图 8-26 所 示 。 
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图 8-26 
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运行 这 个 例子 ， 会 弹出 一 个 窗口 ， 显 示 不 同方 向 的 箭头 ， 每 500 4 
秒 改变 一 次 箭头 方向 ， 按 照 上 、 右 、 下 和 左 的 方向 转动 。 








8.5.2 i GIF ZI) iH 


本 例文 件 名 为 PyQt5/Chapter08/qt08_loadGif.py， 演 示 加 载 GIT 动 画 
效果 。 其 完整 代码 如 下 : 

import sys 

from PyQt5.QtWidgets import QApplication,QLabel ,QWidget 

from PyQt5.QtCore import Qt 

from PyQt5.QtGui import QMovie 

class LoadingGifWin( QWidget): 

def __init__(self,parent=None): 

super(LoadingGifWin, self). init__ (parent) 
self.label=QLabel(",self) 


self.setFixedSize(128,128) 

self.setWindowFlags( Qt.Dialog| Qt.CustomizeWindowHint) 

self. movie=QMovie("./images/loading.gif") 

self.label.setMovie(self.movie) 

self.movie.start() 

if name__=='"__main_': 

app=QApplication(sys.argv) 
loadingGitWin=LoadingGifWin() 
loadingGitWin.show() 
sys.exit(app.exec_()) 


运行 脚本 ， 显 示 效 果 如 图 8-27 所 示 。 








本 例文 件 名 为 PyQt5/Chapter08/qt08_labelStyle.py， 其 核心 代码 如 
P: 
label1=QLabel(self) 
labell.setToolTip(' 这 是 一 个 文本 标签 ") 
labell.setStyleSheet("QLabel{border-image: 
url(./images/python.jpg);}") 
# 设置 标签 的 宽度 和 高 度 
label1.setFixedWidth(476) 
label1.setFixedHeight(259) 





本 例文 件 名 为 PyQt5/Chapter08/qt08_btnStyle.py， 其 核心 代码 如 下 : 
btn1=QPushButton(self ) 
btn1.setMaximumSize(48,48) 
btn1.setMinimumSize(48,48) 
style=" 
QPushButton{ 
border-radius: 30px; 
background-image: url('./images/left.png’); 


btn1.setStyleSheet(style) 
上 面 的 样式 对 所 有 的 QPushButton 都 有 效 。 如 果 需 要 为 指定 按钮 设 
置 背景 图 片 ， 应 该 怎么 做 呢 ? 
需要 调用 QPushButton 对 象 的 setObjectName0) 函 数 ， 为 按钮 对 象 设 
置 一 个 名 字 ， 在 QSS 样 式 中 设置 了 按钮 的 三 种 状态 《正常 按钮 状态 、 妃 
标 蕊 停 在 按钮 上 的 状态 、 按 下 按钮 的 状态 ) 的 背景 图 。 核 心 代码 如 下 : 








运行 脚本 ， 显 示 效 果 如 图 8-28 所 示 。 





图 8-28 


8.6.3 顷 放 图 片 


本 例文 件 名 为 PyQt5/Chapter08/qt08_imgScaled.py， 其 核心 代码 如 


下 : 

# filename 为 图 片 的 路 径 

filename = r".\images\Cloudy 72px.png" 

img = QImage( filename ) 

# 设置 标签 的 宽度 为 120 像素 ， 高 度 为 120 像素 ， 所 加 载 的 图 片 按 照 标签 的 高 度 和 宽度 等 比例 
缩放 


labell = QLabel (self) 

labell.setFixedWidth (120) 

labell.setFixedHeight (120) 

# 缩放 图 片 ， 以 国定 大 小 显示 

result = img.scaled(labell.width(), 
labell.height(),Qt.IgnoreAspectRatio, Qt.SmoothTransformation) ; 

# 在 标签 控件 上 显示 图 片 

labell.setPixmap (QPixmap.fromImage (result) ) 


运行 脚本 ， 显 示 效 果 如 图 8-29 所 示 。 





8.6.4 设置 窗口 透明 


如 果 窗 口 是 透 明 的 ， 那 么 通过 窗口 就 能 看 到 桌面 的 背景 。 要 想 实 现 
窗口 的 透明 效果 ， 那 么 就 需要 设置 窗口 的 透明 度 ， 核 心 代码 如 下 : 
win=QMainWindow() 
win.setWindowOpacity(0.5); 
透明 度 取 值 范围 为 : 0.0〈 全 透明 ) ~ 1.0〈 不 透明 ) ， 默 认 值 为 
1.0。 
本 例文 件 名 为 PyQt5/Chapter08/qt08_WindowOpacity.py， 显 示 效 果 
如 图 8-30 所 示 。 





图 8-30 


8.6.5 ¿QSS 


在 Q 中 经 常 需要 使 用 样式 ， 为 了 降低 耦合 性 〈 与 逻辑 代 码 分 
离 ) ， 我 们 通 第 会 定义 一 个 QSS 文 件 ， 然 后 编写 各 种 控件 〈 如 QLable、 
QLineEdit. QPushButton) 的 样式 ， 最 后 使 用 QApplication 或 
QMainWindow ”来 加 载 样式 ， 这 样 就 可 以 让 整个 应 用 程序 共享 同一 种 样 
IJa 

1.4 5 QSS 

首先 新 建 一 个 扩展 名 为 .qss 的 文件 ， 如 style.qss， 然 后 将 其 加 入 资源 
文件 〈.qrc) 中 。 在 style.qss 文 件 中 编写 样式 代码 ， 例 如 : 

MainWindow{ 
border-image:url(./images/python. jpg); 


} 
QToolTip{ 
border: 1px solid rgb(45,45,45); 
background: white; 
color: red; 
} 
2. 加 载 QSS 
为 了 方便 以 后 调用 ， 可 以 编写 一 个 加 载 样式 的 公共 类 
CommonHelper。 本 例文 件 名 为 PyQt5/Chapter08/CommonHelper.py， 其 
核心 代码 如 下 : 
class CommonHelper : 
def _init (self ) : 


pass 





@staticmethod 
def readQss( style): 
with open( style ,'r') as f: 
return f.read() 
然后 在 主 函 数 中 进行 加 载 。 本 例文 件 名 为 
PyQt5/Chapter08/qt08_loadQss.py， 其 核心 代码 如 下 : 
app=QApplication(sys.argv) 
win=MainWindow() 
styleFile='./style.qss' 
# 换 肤 时 进行 全 局 修改 ， 只 需 修 改 不 同 的 QSS 文 件 即 可 
style=CommonHelper.readQss( styleFile ) 
win.setStyleSheet( style ) 
win.show() 


sys.exit(app.exec_()) 


在 换 肤 时 需要 进行 全 局 修改 ， 只 需 使 用 CommonHelper.readQss() 读 
取 不 同 的 QSS 文 件 即 可 。 
没有 加 载 样 式 时 ， 主 窗口 效果 如 图 8-31 所 示 。 





图 8-31 


加 载 样 式 后 ， 主 窗口 效果 如 图 8-32 所 示 。 





图 8-32 


Qe PyOt 5) key 


在 前 面 的 章节 中 ， 我 们 已 经 介绍 了 PyQt 5 的 基本 用 法 ， 但 是 这 只 
局 限 在 ”PyQt 的 范围 之 内 。 如 果 仪 仅 介 绍 这 些 基本 的 内 容 ， 那 束 太 对 不 
起 伟大 的 Python 语言 了 。PyQt 相对 于 Qt 的 优势 不 仅仅 在 于 Python 的 通 
俗 易 懂 的 语法 规范 ， 还 在 于 PyQt 可 以 集成 利用 Python 的 一 些 非常 流行 
的 模块 库 如 PyInstaller、Pandas、Matplotlib、PyQtGraph、Plotly 等 。 本 
章 就 为 读者 一 一 呈现 这 些 非 常 流行 又 非常 好 用 的 模块 库 在 PyQt ”中 的 应 
用 。 利 用 这 些 模 块 库 ， 可 以 让 我 们 开发 PyQt 的 工作 量 减 小 耕 干 个 数量 
级 ， 真 正 达到 快速 开发 GUI 的 目的 。 
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我 们 使 用 PyQt 5 开发 的 程序 并 不 一 定 是 给 自己 用 ， 也 可 能 是 给 用 户 
或 者 朋友 用 ， 使 用 者 可 能 并 不 知道 如 何 运行 .by ” 文件 ， 这 时 候 就 有 了 
把 .py ”文件 编译 成 .exe ”文件 的 需求 。 本 市 主要 内 容 是 介绍 如 何 通 过 
PyInstallerx} PyQt5 项 目 进 行 打包 ， 生 成 可 执行 的 EXE 文 件 。 

PyInstaller 是 一 个 很 好 用 而 且 免 费 的 打包 工具 ， 文 持 Windows、 
Linux, Mac OS, Jf AH 32 位 和 64 位 系统 。 它 的 官方 网 站 地 址 是 : 
http:/www.pyinstaller.org/。 本 节 主 要 介绍 如 何 通过 PyImstaller 对 PyQt 5 项 
目 进 行 打包 ， 生 成 可 执行 的 EXE 文 件 。 

1. 安 装 Python 3.5+PyQt 5.9 编 译 环境 

安装 Python 3.5+PyQt 5.9 编 译 环 境 ， 请 参考 1.2 节 “PyQt 5 环境 搭 
建 ”"。 安 闭环 境 信 息 如 表 9-1 所 示 。 

2. 安 装 PyInstaller 

(1) 使 用 pip 命令 安装 。 我 们 一 直 强 调 ， 要 使 用 最 偷懒 的 方法 ， 
写 代码 尤其 如 此 。 虽 然 部 分 第 三 方 模块 有 独立 的 EXE 安 壮 包 ， 但 是 使 用 
pip 的 好 处 是 会 自动 安装 第 三 方 模块 所 需要 的 依赖 模块 (比如 ， 在 这 里 
就 帮助 我 们 下 载 了 pypiwin32 这 个 依赖 模块 )。 下 面 使 用 pip 命 令 安装 
PyInstaller 模 块 。 

pip install PyInstaller 
安装 PyInstaller 模 块 成 功 的 提示 信息 如 图 9-1 所 示 。 
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的 安装 目录 
SAR. EBS 


在 Python 


以 
跟 pip 
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我 们 
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AMIE, 
d_software\ 
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(2) PyInstaller 
Scripts 中 找到 pyinstaller.exe 


在 同一 


python35\Scripts， 如 图 9-2 所 


?9 


应 用 程 


的 机 器 上 安装 路 径 是 E:\installe 


ZN o 


> Se > FOF (E) > installed_software » python35 » Scripts 


pus 
eric6_sqibrowser.bat 


eric6_tray.bat 


oe eric6_trpreviewer,. bat 
eric6_uipreviewer.bat 
eric6_unittest. bat 
eric6_webbrowser. bat 
A` futurize exe 
A futurize-script_py 
pasteurize.exe 
A pasteurize-scriptLpy 
“A pip.exe 
“A pip3.S.exe 
"A pip3.exe 
"` pyr-archive_viewer.exe 
A pyrarchive_viewer-script.py 
8.05 


1- pyibindepend.exe 

A pyi-bindepend-script.py 

1 pyigrab_version.exe 

A pyi-grab_version-script_py 
和 pyi-makespec.exe 

A pyi-makespec-script.py 
# pyinstaller.exe 

A pyinstaller-script.py 

a pyr-set_version.exe 

A pyi-set_version-script.py 
A pywin32_postinstall.py 


A pywin32 testall,py 


3.PyInstaller 的 使 用 

PyInstaller 的 使 用 非常 简单 。 因 为 PyInstaller 已 经 在 Scripts 目 录 下 
生成 了 可 执行 的 pyinstaller.exe 文 件 ， 所 以 可 以 在 命令 行 窗口 中 进入 需 
打包 的 代码 所 在 的 目录 下 ， 然 后 运行 下 面 的 命令 : 

pyinstaller [opts]yourprogram.py 

可 选 的 参数 有 : 

e-F,-onefile， 打 包 成 一 个 EXE 文 件 。 

e-D,-onedir， 创 建 一 个 目录 ， 包 含 EXE 文 件 ， 但 会 依赖 很 多 文件 

《默认 选项 ) 。 
e-c,-console,-nowindowed， 使 用 控制 台 ， 无 窗口 (默认 ) 。 


e-w,-windowed,-noconsole， 使 用 窗口 ， 无 控制 全 。 

4. 打 包 测 试 

本 例文 件 名 为 PyQt5/Chapter09/example/colorDialog.py， 其 详细 内 容 
如 下 : 


from PyQt5.Q0tWidgets import QApplication, QPushButton, QColorDialog , 
QWidget 

from PyQt5.QtCore import Qt 

from PyQt5.QtGui import QColor 


import sys 


class ColorDialog ( QWidget): 
def (init (self ic 

Süper) Innie 0 
eolor = QOColorn(0, 07 0) 
self.setGeometry (300, 300, 350, 280) 
self.setWindowTitle('MBiki#') 
self.button = QPushButton('Dialog', self) 
self.button.setFocusPolicy (Qt.NoFocus) 
self.button.move(20, 20) 
self.button.clicked.connect (self.showDialog) 
self.setFocus () 
self.widget = QWidget (self) 
self.widget.setStyleSheet ('QWidget {background-color:%s} 

'Scolor.name() ) 
self.widget.setGeometry(130, 22, 100, 100) 





def showDialog(self): 
col = QColorDialog.getColor() 
EE eto pl Mal 


self.widget.setStyleSheet ('QWidget 


{background-color:%s}'%col.name() ) 


PAT Name T = ma 
app = QApplication(sys.argv) 
qb = ColorDialog() 
qb . show () 


sys.exit(app.exec ()) 


编写 完 colorDialog.py 后 ， 双 击 .py 文件 即 可 运行 ， 因 为 Python 解释 
器 会 去 执行 这 个 .py 文件 〈 当 安装 好 Python 3.5 后 ， 就 会 获得 一 个 官方 版 
本 的 解释 器 ”CPython， 这 个 解释 器 是 使 用 C 语 言 开发 的 ， 在 命令 行 下 运 


ÍT Python 就 是 启动 CPython 解 释 器 ) .双击 colorDialog.py 文 件 ， 可 以 得 到 
如 图 9-3 所 示 的 窗口 。 





图 9-3 





打开 命令 行 窗口 ， 进 入 colorDialog.py 文 件 所 在 的 目录 下 ， 运 行 下 面 


pyinstaller-F-w colorDialog.py 
PyInstaller 目 动 执 行 一 系列 的 项 目 打包 过 程 ， 最 后 生成 EXE 文 件 ， 
如 图 9-4 所 示 。 


D C:\windows\system32\cmd.exe 一 = RE 


INFO: running Analysis out@G-Analysis.toc 

INFO: Caching module hooks 

INFO: Analyzing C:\Users\wangshuo\Desktop\puthon\colorDialog.py 
INFO: Loading module hooks 

INFO: Loading module hook “hook-PyQtS.QtCore. py” 

INFO: Loading module hook “hook-distutils. py” 

INFO: Loading module hook “hook-pydoc. py” 

INFO: Loading module hook “hook-PyQtS. py” 

INFO; Loading module hook “hook~xml.py 

INFO; Loading module hook “hook-PyQtS.Qt. py” 

INFO: Loading module hook “hook~PyQtS.QtWidgets. py” 
INFO: Loading module hook “hook-encodings.py” 

INFO: Loading module hook “hook-PyQtS.QtGui.py” 

INFO: Loading module hook “hook-PyQtS.QtPrintSupport. py” 
INFO: Looking for ctypes DLLs 

INFO: Analyzing run-time hooks : 

INFO: Including run-time hook ‘pyi_rth_qt5S.py’ 

INFO: Including run-time hook ‘pyi_rth_qtSplugins.py’ 
INFO; Looking for dynamic libraries 

INFO: Looking for eggs 

INFO: Using Python library C:\windows\system32\python34.dll 
INFO: Found binding redirects 


7 INFO: Warnings written to C:\Users\wangshuo\Desktop\python\bulld\colorDialo 
io\warncolorDialog. txt 
18006 INFO: checking PYZ 
8007 INFO: Building PYZ because outO8O-PYZ.toc is non existent 
18008 INFO: Building PYZ (Z2libArchive) C:\Users\wangshuo\Desktop\python\build\col 
porDialog\outOO-PYZ.pyz 
89411 INFO: Building PYZ (ZlibArchive) C:\Users\wangshuo\Desktop\python\build\col 
orDialog\outO0-PY2Z.pyz completed successfully 
9445 INFO: checking PKG 
19446 INFO: Building PKG because outOO-PKG.toc is non existent 
S446 INFO: Building PKG (CArchive) outOO-PKG.pkg 
27792 INFO: Building PKG (CArchive) outOO-PKG.pkg completed successfully. 
27818 INFO: Bootloader D:\installed_software\Python34\1lib\site-packages\PyInstal 
Bler\boot loader \Windows-64bit\runw.exe 
27819 INFO: checking EXE 
27819 INFO: Building EXE because out9@-EXE.toc is non existent 
127820 INFO: Building EXE from outO6-EXE. toc 
B27821 INFO: Appending archive to EXE C:\Users\wangshuo\Desktop\python\dist\color 
Dialog exe 
{27894 INFO; Building EXE from out6966-EXE ,toc completed successfully 





图 9-4 





Id 


最 后 在 同 目录 下 的 dist 子 文件 夹 中 生成 了 colorDialog.exe 3c ff, 


图 9-5 和 图 9-6 所 示 。 


如 
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图 9-5 
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双击 colorDialog.exe 文件 ， 其 运行 效果 与 前 面 直接 使 用 Python 解 
释 器 运行 colorDialog.py 的 效果 一 样 。 

说 明 

calculator.exe 可 以 在 未 安装 Python 环境 的 Windows 系 统 上 运行 。 但 
是 由 于 使 用 的 是 64 位 Python 环境 ， 所 以 它 只 能 在 64 位 Windows 系 统 上 运 
行 。 如 果 读 者 使 用 32 位 Python 环境 进行 打包 ， 则 其 结 末 既 可 以 在 32 位 
Windows 系 统 上 运行 ， 也 可 以 在 64 位 Windows 系统 上 运行 。 所 以 如 果 
读者 想 要 打包 程序 的 话 ， 建 议 使 用 32 位 Python 环境 打包 。 

5.PyInstaller 原 理 简 介 

PyInstaller 其 实 就 是 把 ”Python 解释 器 和 脚本 打包 成 一 个 可 执行 文 
件 ， 和 编译 成 真正 的 机 器 码 完全 是 两 回 事 。 所 以 干 万 不 要 指望 打包 成 可 





执行 文件 会 提高 运行 效率 ， 相 反 ， 可 能 会 降低 运行 效率 ， 但 是 这 样 做 的 
好 处 是 在 运行 者 的 机 器 上 不 用 安装 Python 和 脚本 所 依赖 的 库 。 在 “Linux 
操作 系统 下 ， 它 主要 使 用 的 是 binutil 工具 包 中 的 1dd 和 objdump 命 令 。 

输入 指定 的 脚本 后 ， 首 先 PyInstaller 会 分 析 该 脚本 所 依赖 的 其 他 依 
赖 ， 然 后 进行 查找， 并 复制 ， 把 所 有 相关 的 依赖 都 收集 起 来 并 进行 加 密 
处 理 ， 包 括 Python 解 释 器 ， 最 后 把 这 些 文件 放 在 一 个 目录 下 ， 或 者 打包 
到 一 个 可 执行 文件 中 。 

然后 就 可 以 直接 运行 所 生成 的 可 执行 文件 ， 不 需要 安装 其 他 包 或 某 
个 版 本 的 Python 。 需 要 注意 的 是 ， 使 用 PyInstaller 打包 生成 的 可 执行 文 
件 ， 只 能 在 和 打包 机 器 系统 相同 的 环境 下 运行 。 也 束 是 说 ， 这 个 可 执行 
文件 不 具备 可 移植 性 ， 知 需要 在 不 同 的 操作 系统 上 运行 ， 就 必须 在 该 系 
统 环境 上 重新 进行 打包 。 








9.2 % ae: 


9.2.1 SQLite 介 绍 


1. 什 么 是 SQLite 

SQLite 是 一 个 轻 量 级 的 数据 库 ， 实 现 了 自给 自足 、 无 服务 器 、 零 配 
置 、 事 务 性 的 SQL 数据 库 引 擎 ， 其 部 署 最 广泛 。SQLite 源 代 码 不 受 版 
权限 制 。 

SQLite 的 主要 应 用 场景 是 作为 手机 应 用 的 数据 库 以 及 小 型 果 面 软件 
的 数据 库 。 

百度 百科 : SQLite 词 条 

SQLite 是 遵守 ACID 的 关系 型 数据 库 管 理 系 统 ， 它 包含 在 一 个 相对 
小 的 C 库 中 。SQLite 是 D.RichardHipp 建立 的 公有 领域 项 目 ， 其 设计 日 
标 是 嵌入 式 的 ， 目 前 已 经 使 用 在 很 多 肉 入 式 产品 中 ， 它 占用 的 资源 非常 
少 ， 在 上 藤 入 式 设 备 中 可 能 只 需要 几 百 KB 的 内 存 就 够 了 。SQLite 支 持 
Windows、Linuxz、UNIX 等 主流 的 操作 系统 ， 同 时 能 够 与 很 多 程序 语言 
相 结 合 ， 比 如 ”Tcl、C#、PHP、Java 等 ， 还 有 ODBC 接 口 ， 与 MySQL、 
PostgreSQL 这 两 款 开 源 的 数据 库 管 理 系 统 相 比 ， 它 的 处 理 速 度 非常 快 。 

2. 安 装 并 使 用 SQLite 

SQLite 的 官方 下 载 地 址 为 http://www.sqlite.org/download.html， 其 中 
提供 了 多 种 版 本 的 SQLite， 截 至 本 书 成 书 之 时 ， 其 最 新 版 本 是 3.18.0. 
笔者 选择 下 载 的 压缩 包 名 称 为 sqlite-tools-win32-x86-3140200.zip， 下 载 
后 直接 解压 缩 到 磁盘 上 ， 可 以 看 到 解压 缩 后 有 sqlite3.exe 文 件 ， 如 图 9-7 
所 示 。 








> tool > sqlite-tools-win32-x86-3140200 


A 


名 称 大 小 
a ' sqldiff.exe 28 KB 
"| sqlite3.exe 667 KB 


"| sqlite3_analyzer.exe 


图 9-7 


接 下 来 需要 将 SQLite 路 径 加 入 到 Path 环境 变量 中 ， 这 是 为 了 更 方 
便 地 使 用 SQLite。 右 键 单 击 “ 我 的 电脑 *， 从 弹出 的 快捷 菜单 中 选择 “ 属 
性 ”一 “高 级 系统 设置 ” “环境 变量 *”， 在 系统 变量 中 找到 ”Path， 将 解压 
缩 后 的 SQLite 路 径 加 入 到 变量 值 中 。 例 如 ， 在 笔者 的 机 器 上 SQLite 路 
径 是 Ei\installed_software\sqlite， 如 图 9-8 所 示 。 


系统 属性 
| 计算 机 名 | 硬件 SR 系统 保护 | 远程 | 
环境 变量 

















变量 名 (N): 








变量 值 (V): 








Windows_NT 
;.7E:/installed_software/nodejs;E:\installed... 
PATHEXT -COM;.EXE;.BAT;.CMD;.VBS;.VBE;JS; JSE;.W... 
PROCESSOR_ARC... AMD64 
PROCESSOR IDE... _Intel64 Family 6 Model 61 Steppina 4. Ge... ™ 




















FRW.. | SA0. | MRD 








打开 命令 行 窗 口 ， 输 入 sqlite3， 如 果 弹 出 如 图 9-9 所 示 的 信息 ， 就 
表示 SQLite 安 装 成 功 了 。 


E:\>sqlite3 

SQLite version 3.14.2 2016-09-12 18:50:49 
“help” for usage hints. 

Connected to a 


Use “.open FILENAME” to reopen on a persistent database. 
sqlite> 








3.SQLite 常 用 操作 
C1) 新 建 一 个 数据 库 文件 
使 用 cd 命令 进入 到 要 创建 数据 库 文件 的 目录 下 ， 使 用 sqlite3 命 令 创 
建 数 据 库 文件 ， 基 本 语法 如 下 : 
sqlite3 DatabaseName.db 
比如 创建 一 个 新 的 testDb.db 文 件 ， 命 令 如 下 : 
E:\tool > sqlite3 testDb.db 
SQLite version 3.14.2 2016-09-12 18:50:49 
Enter ".help" for usage hints. 

上 面 的 命令 将 在 当前 目录 下 创建 一 个 testDB.db 文 件 ， 该 文件 将 被 
SQLite 引擎 用 作 数 据 库 。 需 要 注意 的 是 ， 使 用 sqlite3 命令 成 功 创建 数 
据 库 文 件 后 ， 将 显示 “sqlite 之 ”提示 符 。 

(2) 查看 已 建立 的 数据 库 文 件 
数据 库 创建 成 功 后 ， 可 以 使 用 SQLite 的 .databases 命 令 来 检查 它 是 
人 否 在 数据 库 列表 中 。 
sqlite > .databases 
seq name file 
0 main E:\tool\testDb.db 


sqlite > 


(3) 打开 已 建立 的 数据 库 文 件 
使 用 cd 命令 进入 到 要 打开 的 数据 库 文件 所 在 的 目录 下 ， 使 用 sqlite3 
命令 打开 数据 库 文件 。 注 意 : 假如 数据 库 文件 不 存在 ， 则 会 新 建 一 个 数 
据 库 文件 。 使 用 命令 sqlite3 testDb.db 会 打开 已 建立 的 数据 库 文件 
testDb.db 。 
E:\tool > sqlite3 testDb.db 
SQLite version 3.14.2 2016-09-12 18:50:49 
Enter ".help" for usage hints. 
sqlite > 
(4) 但 看 帮助 信息 
在 SQLite 命 令 行 模式 下 ， 输 入 .help 命 令 可 以 查看 SQLite 的 帮助 信 


ls 


sqlite > .help 
(5) 创建 表 
在 SQLite 命 令 行 模式 下 ， 输 入 如 下 SQL 脚本 来 创建 表 。 
sqlite > create table people(id integer primary key,name text); 
注意 
使 用 SQLite 生成 的 数据 库 保 存在 一 个 以 .db 为 扩展 名 的 文件 下 ， 比 
如 testDb.db。 这 个 数据 库 文 件 是 轻 量 级 的 ， 可 以 把 SQLite 生 成 的 数据 库 
文件 复制 到 任意 操作 系统 下 ， 比 如 Windows、Linux 或 Mac OS， 在 这 些 
操作 系统 下 的 SQLite 数 据 库 都 可 以 识别 这 个 数据 库 文 件 ， 可 以 使 用 
sqlite3 testDb.db 命 令 打 开 这 个 数据 库 文 件 。 
接 下 来 往 表 中 写 入 一 些 数据 ， 输 入 如 下 SQL 脚 本 : 


sqlite > insert into people(id,name) values(1,'zhangsan'); 








sqlite > insert into people(id,jname) values(2,'lisi'); 
sqlite > insert into people(id,jname) values(3,'wangwu'); 


查询 people 表 的 记录 ， 输 入 如 下 SQL 脚 本 : 


sqlite > select * from people; 
1|zhangsan 
2|lisi 
引 wangwu 
可 以 看 到 ， 从 people 表 返回 的 记录 中 没有 column (4) ， 可 以 使 
用 .header on 命令 开局 表 头 格式 。 


sqlite > .header on 





sqlite > select * from people; 
idjname 
1|zhangsan 
2|lisi 
引 wangwu 
sqlite > 
查询 people 表 结构 : 
sqlite > .Schema people 
CREATE TABLE people(id integer primary key,name text); 
sqlite > 

4. 使 用 SQLite 管 理工 具 

Shell 脚 本 虽然 提供 了 强大 的 功能 ， 但 是 使 用 起 来 不 是 很 方便 ， 笠 运 
的 是 ，SQLite 有 很 多 开源 且 优 秀 的 DBMS 〈 数 据 库 管理 系统 ) ， 提 供 了 
界面 操作 SQLite 数 据 库 。 

在 这 里 笔者 使 用 的 是 SQLiteStudio 软 件 ， 其 官方 下 载 地 址 为 
https://sqlitestudio.pl/index.rvt。 这 球 软 件 是 绿色 的 、 免 安装 的 ， 解 压缩 
后 直接 运行 就 可 以 了 。 笔 者 选择 下 载 的 压缩 包 名 称 为 sqlitestudio- 
3.1.1.zip, Pen bee Reet AE SEE A 
SQLiteStudio.exe 文件， 双击 这 个 文件 就 可 以 打开 = SQLiteStudio. 
SQLiteStudio 的 界面 如 图 9-10 所 示 。 
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图 9-10 


可 以 看 到 ，SQLiteStudio 的 界面 布局 和 SQLServer 很 相近 ， 操 作 也 
很 方便 ， 单 击 SQLiteStudio 菜 单 栏 中 的 “数据 库 ?- “添加 数据 库 ?， 把 需 
要 导入 的 .db 文件 添加 进来 即 可 ， 非 常 简单 ， 读 者 可 自行 尝试 。 


9.2.2 连接 数据 库 


PyQt API 经 过 精心 设计 ， 提 供 了 很 多 基于 SQL 的 数据 库 通信 类 。 
其 中 QSqlDatabase 类 用 来 连接 数据 库 ， 可 以 使 用 数据 库 驱 动 (Driver) 
与 不 同 的 数据 库 进行 交互 。 一 个 QSqlDatabase 实 例 代表 了 一 次 数据 库 连 
接 。 

当前 可 用 的 数据 库 驱 动 类 型 如 表 9-2 所 示 。 





表 9-2 
a 


数据 库 驱 动 类 型 
QDB2 IBM DB2 驱动 程序 


Borland InterBase 开动 程序 
QMYSQL MySQL 驱动 程序 
QOCI Oracle 调用 接口 驱动 程序 














QODBC ODBC 驱动 程序 〈 包 括 Microsoft SQL Server) 


QSQLITE SQLite3 或 更 高 版 本 的 驱动 程序 
QSQLITE2 SQLite2 驱动 程序 


QSqlDatabase 类 中 的 常用 方法 如 表 9-3 所 示 。 


Fi % ii 述 
addDatabase() 设置 连接 数据 库 的 数据 库 驱 动 类 型 
) 














设置 安装 数据 库 的 主机 名 称 
设置 连接 对 象 的 密码 如果 有 ) 





rollback() 回 滚 数 据 库 事务 


使 用 addDatabase0 静 态 方法 创建 一 个 数据 库 连 接 〈 也 就 是 
QSqlDatabase 实 例 ) ， 指 定数 据 库 的 驱动 类 型 和 连接 的 主机 名 称 
Chost) 。 主 机 名 称 是 安装 数据 库 的 主机 IP 地 址 或 域名 。 
QSqlDatabase 还 文 持 默认 连接 ， 没 有 数据 库 名 称 的 连接 就 是 默认 连 
接 。 要 创建 默认 连接 ， 在 调用 addDatabase() 方 法 时 ， 不 传递 所 要 连接 的 
数据 库 名 称 参 数 即 可 。 
下 面 代 码 演示 了 如 何 创 建 并 打开 一 个 到 MySQL 数 据 库 的 连接 。 
from PyQt5.QtSql import QSqlDatabase 
db=QSq|Database.addDatabase("QMYSQL") 
db.setHostName("192.168.55.110") 








db.setDatabaseName("user" 
db.setUserName("root") 
db.setPassword("ctsi123") 
dbConn=db.open() 

如 下 代码 创建 并 打开 了 一 个 到 SQLite 数 据 库 的 默认 连接 。 
from PyQt5.QtSql import QSqlDatabase 
db=QSqIDatabase.addDatabase('QSQLITE') 
db.setDatabaseName('./db/sports.db') 

# 打开 数据 库 
dbConn=db.open() 


9.2.3 执行 SQL 语 所 


QSqlQuery 类 具有 执行 和 操作 SQL 语 句 的 功能 ， 可 以 执行 DDL 和 
DML 类 型 的 SQL 查询 。 该 类 中 最 重要 的 方法 是 exec_()， 它 将 一 个 包含 
要 执行 的 SQL 语句 的 字符 串 作 为 参数 。 

query=QSq|Query() 
query.exec_("create table people(id int primary § key,name 
varchar(20),address varchar(30))") 

本 例文 件 名 为 PyQt5/Chapter09/qt09_db01.py， 演 示 创 建 一 个 SQLite 
数据 库 database.db， 其 中 的 people 表 有 5 条 记录 。 其 完整 代码 如 下 : 





import sys 


from 
from 
from 


from 


PyQt5.QtCore import * 

PyQt5.QtGui import * 

PyQt5.QtWidgets import * 

PyQt5.QtSql import QSqlDatabase , QSqlQuery 


def createDB(): 
db = QSqlDatabase.addDatabase ('QSOLITE') 
db.setDatabaseName('./db/database.db') 


if not db.open(): 


QMessageBox.critical(None, (" 无 法 打开 数据 库 ") ， 
( "无 法 建立 到 数据 库 的 连接 ,这 个 例子 需要 SOLite 支持 ， 请 检查 数据 库 配 置 。 


\n\n 单 击 取消 按钮 退出 应 用 。") ， 


QMessageBox.Cancel ) 


return False 


query = QSqlQuery () 


query.exec ("create table people(id int primary key, name 


varchar (20), address varchar(30))") 


query.exec (“insert into peoplevalues(1, 'zhangsanl', "BéeiJing!')™) 


query.exec: (“insert into people values(2, ‘lisil', "TianJing")") 


query.exec ("insert into people values(3, 'wangwul', 'HenNan')") 


query.exec ("insert into people values(4, ‘lisi2', "HeBei')") 


query.exec ("insert into people values(5, 'wangwu2', 'shanghai')") 
# 关闭 数据 库 
db.close() 


return True 


if pane == mann: 


app = QApplication(sys.argv) 
createDB () 


sys.exit(app.exec ()) 


运行 脚本 ， 使 用 SQLiteStudio 打 开 database.db 数 据 库 文 件 ， 显 示 效 果 
如 图 9-11 所 示 。 可 以 看 到 ， 在 database 数 据 库 中 建立 了 people 表 ， 并 成 功 
插入 了 5 条 记录 。 


6 & 5 8 > 
结构 | 数据 | 约束 | Indexes | 触发 器 | DDL | 
过 滤 名 Grid view | Form view 
Bg ae a -002020 GOTOO > 
> E people... id name address 


= ae 1 zhangsan1 BeiJing 
2 lisi1 TianJing 
3 wangwu1 HenNan 
4 lisi2 HeBei 
5 wangwu2 shanghai 























people (database) | 








图 9-11 


执行 完 SQL 语 句 后 ， 如 果 不 再 执行 其 他 数据 库 操 作 ， 则 必须 执行 
db.close() 语 句 关 闭 数据 库 。 因 为 数据 库 连 接 资 源 是 有 限 的 ， 如 果 程 序 没 
有 关闭 数据 库 连 接 ， 那 么 每 次 执行 SQL 语句 后 都 会 留 下 一 些 没 有 关闭 的 
数据 库 连 接 ， 这 些 连 接 又 不 能 被 重新 使 用 ， 那 么 数据 库 连 接 资源 最 终 将 
被 耗 尽 ， 导 致 程 序 无 法 正常 连接 数据 库 ， 这 样 就 会 影响 数据 库 的 正常 运 
转 。 

在 PyQt 的 窗口 中 常常 需要 读 取 数 据 库 的 记录 并 进行 显示 ， 那 么 在 窗 
口 初始 化 时 就 需要 打开 数据 库 ， 保 持 数据 库 连 接 。 当 单 击 窗口 右上 角 的 
| x akna 口 后 ， 就 需要 重 载 coseEvent(0 事 件 ， 在 事件 中 断 开 
数据 库 连 接 。 本 例文 件 名 为 PyQt5/Chapter09/qt09_db02.py， 演 示 在 关闭 
窗口 时 断 开 数据 连接 。 其 完整 代码 如 下 : 











class ExecDatabaseDemo (QWidget) : 


def _ init (self, parent=None): 


super (ExecDatabaseDemo , self). init (parent) 


self.db = QSqlDatabase.addDatabase('QSQLITE') 
self.db.setDatabaseName('./db/database.db') 
# 打开 数据 库 


self.db.open () 

def closeEvent (self, event): 
# 关闭 数据 库 
self.db.close() 


if name == ' main_': 
app = QApplication(sys.argv) 
demo = ExecDatabaseDemo () 
demo. show () 


sys.exit (app.exec ()) 


9.2.4 4 AIRI 


PyQt 中 的 QSqlTableModel 类 是 一 个 高 级 接口 ， 提 供 了 可 读 的 数据 
模型 ， 用 于 在 单个 表 中 读 取 和 保存 数据 。 此 模型 用 于 填充 QTableView 对 
象 ， 它 癌 用 户 呈 现 了 可 以 放 在 任何 顶层 窗口 中 的 可 滚动 和 可 编辑 的 视 
图 。 

可 以 用 下 列 方 式 声 明 QSqlTableModel 对 象 ， 然 后 查询 people 表 中 的 
数据 ， 最 后 保存 数据 到 QSqlTableModel 对 象 的 只 读数 据 模型 中 。 

model=QtSql.QSqlTableModel() 

model.setTable("people") 
model.setEditStrategy(QSqlTableModel.OnManualSubmit) 
model.setFilter("id > 1") 














model.select() 

model.setHeaderData(0,Qt.Horizontal,"id") 

model.setHeaderData(1,Qt.Horizontal,"name" 

model.setHeaderData(2,Qt.Horizontal,"address") 

view=QTableView(self) 

view.setModel(model) 

view.show() 

QSqlTableModel 类 是 一 个 可 以 读 和 写 的 表格 模型 ， 当 连接 到 数据 库 

后 ， 使 用 setTable0) 函 数 设置 要 查询 的 表 ， 使 用 setFilterO 函 数 设置 过 滤器 
条 件 ， 这 个 过 滤器 条 件 与 SQL 查询 语句 中 的 where 条 件 一 样 ， 然 后 使 用 
selectO 函 数 执 行 查 询 ， 最 后 使 用 setEditStrategy0O0 函 数 设置 “编辑 策略 ”。 
可 设置 的 编辑 策略 如 表 9-4 所 示 。 


表 9-4 


编辑 策略 





QSqlTableModel.OnFieldChange 所 有 变更 实时 更 新 到 数据 库 中 
QSqlTableModel.OnRowChange 当 用 户 选 择 不 同 的 行 时 ， 在 当前 行进 行 变更 
QSqlTableModel.OnManualSubmit 手动 提交 ， 不 上 自动 提交 


本 例文 件 名 为 PyQt5/Chapter09/gt09_db03.py， 演 示 在 PyQt 5 的 窗 
口中 使 用 QSqlTableModel 控 件 。 其 完整 代码 如 下 : 











运行 脚本 ， 显 示 效 果 如 图 9-12 所 示 。 





name address 
BeiJing 
lisi1 TianJing 
wangwu1 HenNan 


lisi2 HeBei 


wangwu2 shanghai 

















代码 分 析 : 
在 这 个 例子 中 ，people 表 被 当 作 模 型 ， 编 辑 琐 略 被 设置 为 
QSqlTableModel.OnFieldChange。 其 核心 代码 如 下 : 
model.setTable(‘people’) 
model.setEditStrategy( QSqlTableModel.OnFieldChange) 
model.select() 
QTableView 类 是 一 个 窗口 ， 是 用 来 显示 数据 的 。 创 建 QTableView 
对 象 的 核心 代码 如 下 : 


def create View(title,model): 





view=QTableView() 
view.setModel(model) 
view.setWindow Title(title) 
return view 
以 上 代码 将 一 个 QTableView 对 象 和 两 个 QPushButton 控 件 添加 到 
QDialog (MEAO) 中 。 还 需要 将 添加 按钮 的 clicked 信 号 连接 到 槽 函 
数 addrow()。 显 示 效 果 如 图 9-13 所 示 。 单 击 “ 深 加 一 行 ?按钮 ， 会 在 窗口 
中 添加 一 行 空 白 记 录 ， 使 用 了 QSqlTableModel 对 象 的 insertRowsO 函 数 。 
它 的 核心 代码 如 下 : 
addBtn.clicked.connect(addrow) 
def addrow(): 
ret=model.insertRows( model.rowCount(),1 ) 


print( 'insertRows=%s' %str(ret) ) 


name address 


zhangsan1 BeiJing 
lisi1 TianJing 
wangwu1 HenNan 


lisi2 HeBei 


wangwu2 shanghai 








图 9-13 
与 删除 按钮 相关 联 的 槽 函数 执行 一 个 lambda 功 能 ， 删 除 用 户 所 选择 
delBtn=QPushButton(" 删 除 一 行 ") 


delBtn.clicked.connect(lambda: 


model.removeRow(view1.currentIndex().row())) 


9.2.5 封装 分 页 查询 控 


本 节 内 容 用 到 了 前 几 章 介绍 的 知识 。 本 例文 件 名 为 
PyQt5/Chapter09/DataGrid.py， 演 示 了 自 定 义 分 页 查询 控件 ， 效 果 如 图 9- 
14 上 所 示 。 
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图 9-14 
1. 准 备 分 页 数据 
本 例 中 使 用 的 分 页 数据 保存 在 SQLite 数 据 库 的 student 表 中 ，SQLite 


数据 库 文件 命名 为 database.db， 保 存在 PyQt5/Chapter09/db 文 件 夹 下 。 在 
student 表 中 保存 的 是 某所 大 学 的 学 后 数 据 ， 其 数据 结构 如 表 9-5 所 示 。 





表 9-5 
| 列 名 | amx 
a a 


Ei ee E | 
| 
ET 和 | | 

创建 student 表 并 插入 数据 有 两 种 方法 : 第 一 种 方法 是 使 用 SQLite 


人 人 


命令 ， 第 二 种 方法 是 使 用 Python 程序 。 下 面 分 别 介绍 这 两 种 方法 。 





一 种 方法 : 使 用 SQLite 命 令 创 建 student 表 并 插入 记录 。 
首先 ， 使 用 SQLite 命 令 创建 student 表 。 
E:\quant\PyQt5\Chapter05\db > sqlite3 datagrid.db 
SQLite version 3.14.2 2016-09-12 18:50:49 
Enter ".help" for usage hints. 
sqlite > create table student(id int primary key,name vchar,sex 
vchar,age int,deparment vchar) ; 
然后 ， 在 student 表 中 插入 10 条 学 生 记 录 。 
sqlite > insert into student values(1, 张 三 1, 男 ,20," 计 算 机 ]) ; 
sqlite > insert into student values(2, 李 四 1, 男 ,19, 经 管 ) ; 
sqlite > insert into student ee its es 机 械 ) ; 
sqlite > insert into student values(4,' 赵 六 1',' 男 ',21,' 法 律 ") ; 
sqlite > insert into student values(5,'/)\ 84 1','55',20,"218') ; 
sqlite > insert into student values(6,'/)S2=1','',19, iF HAL) ; 
sqlite > insert into student values(7, 小 张 1, 男 ,20,' 机 械 ) ; 
sqlite > insert into student values(8," 小 刚 1',' 男 ',19,' 经 管 '") ; 
sqlite > insert into student values(9, 5% =2',' B01" 计算 机 ) ; 
sqlite > insert into student values(10, 张 三 3, 女 ,20, 法 律 ) ; 
可 以 看 到 ， 往 student 表 中 成 功 插入 了 10 条 学 生 记 录 。 
第 二 种 方法 : 使 用 Python 程序 创建 student 表 并 插入 数据 。 
以 下 代码 在 窗口 初始 化 时 执行 。 这 上 段 代 码 非 常 直观 ， 这 里 就 不 解释 





is 


def createTableAndInit(): 
# 添加 数据 库 
db = QSqlDatabase.addDatabase ('QSQLITE') 
# 设置 数据 库 名 称 
db.setDatabaseName('./db/database.db') 
# 判断 是 否 打 开 数 据 库 
if not db.open(): 


return False 


# 声明 数据 库 查 询 对 象 

query = QSqlQuery () 

# 创建 表 

query.exec ("create table student (id int primary key, name vchar, sex 


vchar, age int, deparment vchar)") 


# 添加 记录 

query.exec("insert into student values (1, ' 张 三 11,1 男 1 20, 1 计算 机 ')") 
query.exec("insert into student values(2,'#W1','#',19,'#4#')") 
query.exec("insert into student values(3,'£H1','#',22, '#m')") 
query.exec("insert into student values (4,'RA1','#',21, "法 律 ')") 
query.exec ("insert into student values(5,' 小 明 1',' 男 ',20,' 英 语 ')") 
query.exec ("insert into student values (6, ' 小 李 1',' 女 ',19, ' 计 算 机 ')") 
query.exec("insert into student values (7;,' 小 张 1',' 男 ';20,' 机 械 ')") 
query.exec("insert into student values (8,' 小 刚 1',' 男 ',19, ' 经 管 ')") 
query.exec("insert into student values (9, ' 张 三 2',' 男 ', 21,; ' 计 算 机 ')") 
guery.-exec ("insert into student values(10; k= 3" Rn, 20, AA 


return True 


2. 创 建 分 页 窗口 控件 

接 下 来 创建 一 个 分 页 控件 类 DataGrid， 在 这 个 类 的 初始 化 函数 
int _() 中 声明 所 用 到 的 控件 ， 比 如 提示 数据 表 控 件 、 标 签 、 前 一 页 、 
后 一 页 和 跳 转 按钮 等 。 

本 例文 件 名 为 PyQt5/Chapter09/DataGrid.py， 其 核心 代码 如 下 : 


class DataGrid (QWidget): 


def init (self): 
Supers init 0 
self.setWindowTitle ("分 页 查询 例子 ") 
self.resize(750,300) 


# 查询 模型 

self.queryModel = None 

# 数据 表 

self.tableView = None 

# 总 页 数 文本 
self.totalPageLabel = None 

# 当前 页 文本 
self.currentPageLabel = None 
# 转 到 页 输入 框 
self.switchPageLineEdit = None 
# 前 一 页 按钮 

self.prevButton = None 

# 后 一 页 按钮 

self.nextButton = None 

# 转 到 页 按钮 
self.switchPageButton = None 
# 当前 页 

self.currentPage = 0 

# 总 页 数 

self.totalPage = 0 

# 总 记录 数 
self.totalRecrodCount = 0 

# 每 页 显示 记录 数 


self.PageRecordCount = 5 





现在 创建 窗口 。 窗 口 分 为 三 个 部 分 ， 其 中 第 一 部 分 放置 前 一 页 和 后 
一 页 按钮 的 水 平 栏 ， 第 二 部 分 放置 显示 学 生 信 息 的 数据 表 控 件 ， 第 三 部 
分 显示 当前 所 在 页 数 的 水 平 栏 。 因 为 第 三 部 分 要 讲解 的 内 容 和 第 一 部 分 
类 似 ， 所 以 下 面 就 不 讲 第 三 部 分 了 ， 该 者 可 以 找到 相应 的 代码 文件 自行 
碍 看 ， 其 中 对 关键 部 分 都 做 了 注释 ， 比 较 容 易 理解 。 











第 一 部 分 ， 初 始 化 前 一 页 、 后 一 页 和 跳 转 按 钮 控件 ， 以 及 相关 的 标 
签 控 件 。 核 心 代码 如 下 : 

# 操作 布局 

operatorLayout=QHBoxLayout() 

self.prevButton=QPushButton(" Aif — H") 

self.nextButton=QPushButton("Ja— 91") 

self.switchPageButton=QPushButton("Go") 

self.switchPageLineEdit=QLineEdit() 

self.switchPageLineEdit.setFixedWidth(40) 

switchPage=QLabel(" 转 到 第 ") 

page=QLabel(" i") 

operatorLayout.addWidget(self.prevButton) 

operatorLayout.addWidget(self.nextButton) 

operatorLayout.addWidget(switchPage) 

operatorLayout.addWidget(self.switchPageLineEdit) 

operatorLayout.addWidget(page) 

operatorLayout.addWidget(self.switchPageButton) 

operatorLayout.addWidget( QSplitter()) 

第 二 部 分 ， 初 始 化 显示 学 生 信息 的 数据 表 控 件 ， 设 置 表格 中 单元 格 
的 宽度 上 自动 适应 所 要 显示 的 数据 。 核 心 代码 如 下 : 

# 设置 表格 属性 

self.tableView=QTableView() 

self.tableView.horizontalHeader().setStretchLastSection(True) 








self.tableView.horizontalHeader().setSectionResizeMode( 
QHeaderView.Stretch) 
最 后 创建 分 页 控件 的 主 窗口 。 在 主 窗口 中 添加 第 一 部 分 的 布局 和 第 
二 部 分 的 表格 控件 。 核 心 代码 如 下 : 





mainLayout=QVBoxLayout(self); 
mainLayout.addLayout(operatorLayout); 
mainLayout.addWidget(self.table View); 
mainLayout.addLayout(statusLayout); 


self.setLayout(mainLayout) 


效果 如 图 9-15 所 示 。 


前 一 页 后 一 页 | 转 到 第 页 Go 


图 9-15 





3. 获 取 表 格 控 件 用 到 的 数据 
声明 查询 模型 类 QSqlQueryModel， 然 后 读 取 database.db 数 据 库 中 的 
student 表 ， 放 到 QSqlQueryModel 中 。 核 心 代码 如 下 : 


def setTableView(self): 
self.db = QSqlDatabase.addDatabase ('QSOLITE') 
# 设置 数据 库 名 称 
self.db.setDatabaseName ('./db/database.db') 
# 打开 数据 库 
self.db.open () 
# 声明 查询 模型 
self.queryModel = QSqlQueryModel (self) 
# 记录 查询 
self.recordQuery (0) 
# 设置 模型 
self.tableView.setModel (self.queryModel) 
# 设置 表格 头 
self.queryModel.setHeaderData(0,Qt.Horizontal,"4#45") 
self.queryModel.setHeaderData(1,Qt.Horizontal,"#4") 
self.queryModel.setHeaderData(2,Qt.Horizontal, "性 别 ") 
self.queryModel.setHeaderData (3,Qt.Horizontal, "年 龄 ") 
self.queryModel.setHeaderData (4,Qt.Horizontal," 院 系 ") 


# 记录 查询 
def recordQuery(self, limitIndex ) : 
szQuery = ("select * from student limit %d,%d" % ( limitIndex , 
self.PageRecordCount ) ) 


self.queryModel.setQuery (szQuery) 





最 后 ， 给 前 一 页 、 后 一 页 和 跳 转 按钮 添加 信号 与 槽 ， 当 单 击 按钮 控 
件 时 触发 目 定 义 的 槽 函数 。 核 心 代码 如 下 : 


self.updateStatus () 


# 后 一 页 按钮 被 按 下 
def onNextButtonClick(self): 
print (*** onNextBuctonclick "); 
limitIndex = self.currentPage * self.PageRecordCount 
self.recordQuery( limitIndex) 
self.currentPage += 1 
self.updateStatus () 


+ 跳 转 按钮 被 按 下 
def onSwitchPageButtonClick(self): 
# 得 到 输入 字符 囊 
szText = self.switchPageLineEdit.text () 
# 数字 正则 表达 式 
pattern = re.compile(r'*[-+]?[0-9]+\.[0-9]+$") 


match = pattern.match(szText) 


# 判断 是 否 为 数字 
if not match 
QMessageBox.information(self, "提示 "，" 请 输入 数字 " ) 


return 


# 是 否 为 空 
if szText == '' 
QMessageBox.information(self, "T" ，" 请 输入 跳 转 页 面 " ) 


return 


# 得 到 页 数 
pageIndex = int (szText) 
# 判断 是 否 有 指定 页 
if pageIndex > self.totalPage or pageIndex < 1 
QMessageBox.information(self, "7T", 
"没有 指定 的 页 面 ， 请 重新 输入 " ) 


return 


# 得 到 查询 起 始 行 号 


limitIndex = (pageIndex-1) * self.PageRecordCount 


# 记录 查询 


self.recordQuery (limitIndex) ; 


9.3 Pandas 任 PvQt 中 的 以 


Pandas 是 Python 的 一 个 数据 分 析 包 ， 是 由 AQR Capital Management 
在 2008 年 4 月 开发 的 ， 并 于 2009 年 年 底 开 源 ， 目 前 由 专注 于 Python 数据 
包 开 发 的 PyData 开 发 组 继续 开发 和 维护 ， 属 于 PyData 项 目的 一 部 分 。 
Pandas 最 初 是 被 作为 金融 数据 分 析 工 具 而 开发 的 ， 并 为 时 间 序 列 分 析 提 
供 了 很 好 的 支持 。 从 Pandas 这 个 名 称 就 可 以 看 出 ， 它 是 面板 数据 (Panel 
Data) 和 Python 数据 分 析 (Data Analysis) 的 结合 。 在 Pandas 出 现 之 前 ， 
Python 数据 分 析 的 主力 军 只 有 NumPy 比 较 好 用 ; 在 Pandas 出 现 之 后 ， 它 
基本 上 占据 了 Python 数据 分 析 的 霸主 地 位 ， 它 在 处 理 基 础 数据 尤其 是 金 
融 时 间 序 列 数据 方面 非常 高 效 。 

使 Pandas 与 PyQt 结 合 ， 最 方便 的 方法 就 是 安装 qtpandas 模 块 库 。 这 
个 模块 库 帮助 我 们 把 Pandas 的 数据 显示 在 QTableWidget 上 ， 并 自动 实 
现 各 种 QTableWidget 的 功能 ， 如 增加 、 删 除 、 修 改 、 保 存 、 排 友 等 。 这 
些 功能 实现 起 来 比较 有 碎 烦 ， 但 是 利用 gqtpandas， 我 们 就 可 以 无 须 费 力 地 
手动 重新 实现 。 











9.3.1 qtpandas 的 安装 


首先 安装 Pandas， 最 简单 的 方式 就 是 使 用 pip 命 令 。 
pip install pandas 
pip 默认 的 镜像 源 在 国外 ， 所 以 在 安装 Pandas 时 经 常会 遇 到 超时 间 
， 可 以 改 用 国内 清华 大 学 TUNA 的 镜像 源 ，pypi 镜 像 每 5 分 钟 同 步 一 
次 。 注 意 : 清华 大 学 TUNA 的 镜像 源 地 址 里 的 simple 不 能 少 ， 还 有 使 用 
的 是 https 而 不 是 http。 


x & 


pip install-i https://pypi.tuna.tsinghua.edu.cn/simple pandas 

然后 安装 qtpandas， 它 是 Pandas 的 一 个 依赖 库 ， 同 样 也 使 用 pip 命 令 

进行 安装 。 
pip install qtpandas 

使 用 pip install 命 令 安 装 的 qtpandas 版 本 是 1.03。 也 就 是 说 ，gqtpandas 
提供 的 官方 版 本 是 1.03， 但 是 这 个 版 本 的 qtpandas 依 赖 的 是 PyQt4 版 本 ， 
所 以 如 果 把 这 个 版 本 的 qtpandas 集 成 到 PyQt5 环 境 下 则 会 报错 。 

其 实 qtpandas 最 新 版 1.04 的 代码 已 经 开始 正式 支持 PyQt 5， 但 是 
qtpandas 官 方 还 没有 发 布 到 公 网 镜像 上 ， 需 要 使 用 git 命令 将 pypandas 
的 最 新 版 克隆 下 来 ， 然 后 手动 安装 。 

第 一 种 方法 : 使 用 git 命 令 下 载 最 新 版 的 qtpandas， 然 后 使 用 命令 安 
装 。 

对 于 熟悉 git 命 令 的 读者 ， 可 以 使 用 如 下 命令 安装 qtpandas。 

git clone https://github.com/draperjames/qtpandas. git 
cd qtpandas 
python setup.py install 

第 二 种 方法 : 从 qtpandas 官 网 下 载 最 新 版 的 代码 ， 然 后 使 用 命令 安 

装 。 
首先 ， 访 问 qtpandas 的 官方 网 站 : 
https://github.com/draperjames/qtpandas. 

然后 ， 在 页 面 的 Code 导 航 栏 下 单 击 “Clone or download” 按 钮 ， 选 
择 “Download ZIP”， 下 载 最 新 版 的 qtpandas 压 缩 包 ， 文 件 名 是 qtpandas- 
master.zip， 解 压缩 这 个 zip 文 件 。 输 入 以 下 命令 安装 qtpandas。 

cd qtpandas 
python setup.py install 

如 果 安 装 成 功 ， 在 命令 行 输入 pip show qtpandas 命 令 ， 则 会 得 到 如 

下 信息 。 


C:\Users\si\Downloads\qtpandas-master > pip show gtpandas 
Name: qtpandas 
Version: 1.0.4 
Summary: Utilities to use pandas (the data analysis / manipulation 
Home-page: None 
Author: None 
Author-email: None 
License: None 
Location: e:\installed_software\python35\lib\site-packages\ 
qtpandas-1.0.4-py3.5. 
Requires: pandas, easy gui,pytest, pytest-qt,qtpy, future, pytest-cov 
表示 dtpandas 已 经 安装 成 功 ， 它 的 最 新 版 本 是 1.04。 
注意 
有 了 时候 会 存在 这 种 现象 : qtpandas 安 装 时 出 错 ， 但 是 打开 Python 却 
可 以 import ae 这 时 候 可 以 尝试 运行 本 市 的 案例 ， 如 果 能 够 运行 
成 功 ， 则 可 以 忽略 这 个 错误 。 





from _ future import unicode literals 


from future import print function 


from future import division 

from future import absolute import 
from future import standard library 
standard library.install aliases () 

import pandas 

import numpy 

import sys 

from qtpandas.excepthook import excepthook 


# 使 用 compat 模块 中 的 QtGui 类 ， 请 确保 安装 了 必需 的 sip 库 

from qtpandas.compat import QtGui 

from qtpandas.models.DataFrameModel import DataFrameModel 
from qtpandas.views.DataTableView import DataTableWidget 


# from qtpandas.views. ui import icons rc 
sys.excepthook = excepthook # 设置 PyQt 的 异常 钩子 ， 在 本 例 中 基本 没什么 用 


# 创建 一 个 空 的 模型 ， 该 模型 用 于 存储 与 处 理 数据 
model = DataFrameModel () 


# 创建 一 个 应 用 用 于 显示 表格 

app = QtGui.QApplication([]) 

widget = DataTableWidget() # 创建 一 个 空 的 表格 ， 主 要 用 来 呈现 数据 
widget.resize(500, 300) # 调整 Widget 的 大 小 

widget.show() 

# 让 表格 绑 定 模型 ， 也 就 是 让 表格 呈现 模型 的 内 容 

widget .setViewModel (model) 


# 创建 测试 数据 
data = { 
Nese DOs bibs ALF 
Bte TO 2i; Sails 
tet: [Peter Pan’, "Cpt. Hook", "Tinkerbelr"] 
} 
df = pandas. DataFrame (data) 


# 下 面 两 列 用 来 测试 委托 是 否 成 立 
df['A'] = df['A'].astype(numpy.int8) # A 列 数 据 格 式 变 成 整 型 
df['B'] = df['B'] .astype (numpy.float16) # B 列 数据 格式 变 成 浮 点 型 


# 在 模型 中 填 入 数据 df 
model.setDataFrame (df) 


# 启动 程序 


app.exec () 





这 是 来 自 官方 示例 的 BasicExample.py 的 内 容 ， 这 个 示例 可 以 在 这 
里 找到 : https://github.com/draperjames/qtpandas/tree/master/examples。 其 
运行 结果 如 图 9-16 所 示 。 











图 9-16 


在 图 9-16 中 ， 上 方 第 一 排 按钮 用 于 管理 表格 ， 在 这 里 可 以 对 表格 进 
行 增加 、 删 除 行列 操作 ， 如 图 9-17 所 示 。 
我 们 注意 到 这 个 示例 用 到 了 PyQt 的 委托 概念 ， 下 面 进行 解释 。 请 看 





图 9-18、 图 9-19 和 图 9-20。 


图 9-17 
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图 9-18 
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图 9-19 
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图 9-20 


我 们 看 到 对 于 不 同类 型 的 列 ， 其 外 观 和 编辑 操作 古 不 一 样 的 ， 这 残 
是 委托 的 作用 一 一 实现 完全 控制 表格 的 外 观 显 示 和 编辑 操作 。 

单 击 新 增 列 的 按钮 ， 可 以 选择 不 同 的 数据 类 型 ， 对 应 不 同 的 委托 ， 
从 而 会 显示 不 同 的 外 观 和 编辑 操作 ， 如 图 9-21 所 示 。 



















E) pythonw 


Add a new attribute column 


foe a 


text 


integer (64 bit) 

unsigned small integer (8 bit) 
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unsigned integer (32 bit 
unsigned integer (64 bit) 
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floating i number (32 bit) 


va py value 


date and time 
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图 9-21 


通过 官方 示例 应 用 我 们 知道 ，qtpandas 基本 上 做 完了 Pandas 与 
PyQt 结合 的 所 有 事情 ， 剩 下 的 就 是 调用 了 。 那 么 ， 如 何 把 qtpandas 散 入 
PyQt 的 主 窗 口中 ， 而 不 是 像 现在 这 样 成 为 一 个 独立 的 窗口 呢 ? 这 就 是 本 
节 要 介绍 的 主要 内 容 。 

在 这 个 例子 中 ， 其 核心 代码 是 下 面 几 行 ， 我 们 只 需 把 这 几 行 代码 放 
入 PyQt 的 代码 中 就 行 了 。 

# 创建 一 个 空 的 模型 ， 该 模型 用 于 存储 与 处 理 数据 
model=DataFrameModel() 
widget=DataTableWidget() # 创建 一 个 空 的 表格 ， 主 要 用 来 呈现 数 











Hi 
widget.resize(500,300) # 调整 Widget 的 大 小 


widget.show() 

# 让 表格 绑 定 模型 ， 也 就 是 让 表格 呈现 模型 的 内 容 
widget.setViewModel(model) 

# 在 模型 中 填 入 数据 df 

model.setDataFrame(df) 

但 是 对 于 初学 者 来 说 ， 他 们 更 关心 如 何 使 用 Qt Designer 来 实现 
Pandas 与 PyQt 的 结合 ， 这 时 就 会 产生 一 个 问题 : 在 Qt Designer 中 并 没 
有 DataTableWidget 和 DataFrameModel 这 两 个 类 对 应 的 窗口 控件 ， 那 么 
该 如 何 把 它们 租 入 到 Qt Designer FWE? 这 就 引出 了 本 章 要 介绍 的 另 一 个 
内 容 : 提升 的 窗口 控件 。 














9.3.3 设 











所 谓 提 升 的 窗口 控件 ， 就 是 指 有 些 窗口 控件 是 用 户 自 己基 于 PyQt 定 
义 的 衍生 窗口 控件 ， 这 些 窗口 控件 在 Qt Designer 中 没有 直接 提供 ， 但 是 
可 以 通过 提升 的 窗口 控件 这 个 功能 来 实现 。 具 体 方 法 如 下 : 

从 Container 导 航 栏 中 找到 QWidget 并 拖 入 主 窗口 中 ， 然 后 对 其 单 击 
鼠标 右键 ， 从 弹出 的 快捷 菜单 中 选择 “提升 ?， 打 开 * 提 升 的 窗口 控件 ?对 
话 框 ， 如 图 9-22 所 示 ， 按 照 图 中 所 示 进 行 输入 。 


D 提升 的 窗口 部 件 Qt Designer 


提升 的 类 
名 称 头 文件 全 局 包含 用 法 











新 建 提升 的 类 
基 类 名 称 : Qi dget v 


提升 的 类 名 称 : 
头 文件 : 


全 局 包 合 口 





图 9-22 


单 击 “ 添 加 ?按钮 ， 会 发 现在 “提升 的 类 ”中 多 了 一 项 ， 如 图 9-23 所 

7B o 
选中 它 ， 然 后 单 击 “ 提 升 ?按钮 ， 则 会 在 对 象 得 看 器 中 看 到 如 图 9-24 
所 示 的 内 容 ， 这 说 明 已 经 成 功 地 在 Qt Designer 中 引入 了 DataTableWidget 


类 。 


O 提升 的 窗口 部 件 Qt Designer 


提升 的 类 





图 9-23 


对 象 查看 可 


ws 类 
Y MainWindow QMainWindow 
v &%® centralwidget [| QWidget 
® widget (| DataTableWidget 
menubar QMenuBar 
statusbar QStatusBar 


图 9-24 








我 们 对 Widget 重 命名 为 "pandastablewidget”， 这 样 就 基本 完成 了 对 
提升 的 窗口 控件 的 操作 。 核 心 代码 如 下 : 
from qtpandas.views.DataTableView import DataTableWidget 
self.pandastablewidget=DataTableWidget(self.central Widget) 
self.pandastablewidget.setGeometry(QtCore.QRect(10,30,591,331)) 
self.pandastablewidget.setStyleSheet("") 
self.pandastablewidget.setObjectName("pandastablewidget") 
至 此 ， 我 们 已 经 实现 了 DataTableWidget 类 在 Qt Designer 中 的 引用 。 
提升 的 窗口 控件 是 PyQt 中 非常 简单 、 实 用 而 又 强大 的 功能 ， 利 用 该 
功能 可 以 通过 Qt Designer 来 实现 PyQt 与 Python 的 一 些 强大 的 模块 之 间 的 
交互 功能 ， 可 以 充分 利用 PyQt 和 Python 两 者 的 优点 来 快速 开发 程序 。 
接 下 来 要 介绍 的 内 容 都 是 基于 这 个 功能 展开 的 。 


9.3.4 qtpandas 的 使 用 


在 前 面 内 容 的 基础 上 ， 我 们 再 添加 两 个 按钮 ， 并 设置 clicked 的 
fa, SU 9-25 所 示 。 





图 9-25 


具体 代码 如 下 (对 应 的 文件 为 pandas_pyqt.py): 


运行 脚本 ， 显 示 效 果 如 图 9-26 所 示 。 
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< > 





数据 初始 化 


RFR 





图 9-26 


基本 上 可 以 实现 我 们 对 表格 的 绝 大 部 分 操作 ， 如 增加 、 删 除 、 修 
改 、 保 存 等 。 比 如 对 于 保存 操作 ， 我 们 删除 儿 列 ， 如 图 9-27 所 示 。 
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打开 fund_data_new.xlsxX， 发 现 结果 一 致 ， 如 图 9-28 所 示 。 


图 9-27 
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图 9-28 


对 于 初始 化 数据 ， 该 者 可 以 上 自己 答 试 。 


9.4 Matplotlib Œ PyOt'# HI Dv. 





说 起 Python 的 绘图 模块 ， 就 不 得 不 提 Matplotlib， 基 本 上 每 个 学 习 
Python 绘 图 的 人 都 会 接触 到 Matplotlib， 而 且 应 该 是 接触 的 第 一 个 绘图 模 
块 。 

Matplotlib 是 Python 最 著名 的 绘图 库 ， 它 提供 了 一 整套 和 MATLAB 
相似 的 命令 API， 十 分 适合 交互 式 进 行 制图 。 而 且 也 可 以 方便 地 将 它 作 
为 绘图 控件 ， 骨 入 到 GUI 应 用 程序 中 。 

Matplotlib ”的 文档 相当 完备 ， 并 且 其 Gallery 页 面 ONAE: 
http://matplotlib.org/gallery.html) 中 有 上 百 张 缩 略图 ， 打 开 之 后 就 能 
到 绘图 的 源 代 码 。 这 些 图 像 基本 可 以 满足 我 们 日 常 的 绘图 需求 ， 如 果 能 
够 把 Matplotlib 艇 入 到 PyQt 中 ， 那 么 在 大 多 数 情况 下 就 不 需要 通过 底层 
方式 手动 来 实现 PyQt 的 绘图 功能 了 。 可 以 直接 在 Gallery 页 面 中 找到 符 
合 要 求 的 图 人像， 获取 该 图 像 的 源 代码 ， 进 行 简 单 的 修改 ， 然 后 散 入 到 
PyQt 中 就 可 以 了 。 实 际 上 ， 通 过 底层 方式 来 实现 PyQt 的 绘图 功能 并 不 是 
本 书 的 重点 ， 而 且 这 部 分 内 容 也 比较 难以 理解 。 

本 章 通 过 MatplotlibWidget.py 文 件 来 实现 Matplotlib 与 PyQt 的 结合 ， 
从 实现 这 个 功能 的 角度 来 说 ， 这 应 该 是 笔者 所 见 到 的 最 简单 的 示例 了 。 


9.4.1 对 MatplotlibWidget 的 解读 


1. 设 置 绘图 类 

本 例文 件 名 为 PyQt5/Chapter09/MatplotlibWidget.py， 首 先 创 建 
FigureCanvas 类 ， 在 其 初始 化 过 程 中 建立 一 个 空白 的 图 像 。 注 意 ， 下 面 
代码 的 开头 两 行 是 用 来 解决 中 文 和 负 号 显示 问题 的 ， 也 可 以 把 它 应 用 到 

















使 用 Matplotlib 进 行 的 日 常 绘 图 中 。 


class MyMplCanvas (FigureCanvas): 
"wnFigureCanvas 的 最 终 父 类 其 实 是 QWidget""" 


def init (self, parent=None, width=5, height=4, dpi=100): 


# 设置 中 文 显示 


plt.rcParams['font.family'] = ['SimHei'] 间 用 来 正常 显示 中 文 标签 
= fi 
= 


显 
plt.rcParams['axes.unicode minus'] = False # 用 来 正常 显示 


# 新 建 一 个 绘图 对 象 


self.fig = Figure(figsize=(width, height), dpi=dpi) 
# 建立 一 个 子 图 。 如 果 要 建立 复合 图 ， 可 以 在 这 里 修改 
self.axes = self.fig.add subplot (111) 


self.axes.hold(False) # 每 次 绘图 时 都 不 保留 上 一 次 绘图 的 结果 


RISEeCanVasa init (self, self- fig) 


self.setParent (parent) 


'11 定 义 FigureCanvas 的 尺寸 策略 ， 意 思 是 设置 FigureCanvas， 使 之 尽 可 能 向 
外 填充 空间 '' 
FigureCanvas.setSizePolicy(self, 
QSizePolicy.Expanding, 
QSizePolicy.Expanding) 


FigureCanvas.updateGeometry (self) 


绘制 静态 图 函数 ， 调 用 这 个 函数 可 以 在 上 一 步 押 创建 的 空白 的 
ne 。 注 意 ， 这 部 分 内 容 可 以 随意 定义 ， 可 以 在 Gallery 页 面 中 找 
到 上 自己 震 要 的 图 像 ， 获 取 其 源 代码 ， 然 后 对 议 态 函数 
(start_static_plot) 中 的 相关 代码 进行 蔡 换 即 可 。 

"绘制 静态 图 ， 可 以 在 这 里 定义 绘图 逻辑 " 
def start_static_plot(self): 


self.fig.suptitle( 测 斌 静态 图 ") 
t=arange(0.0,3.0,0.01) 
s=sin(2 * pi * t) 
self.axes.plot(t,s) 
self.axes.set_ylabel(' 静 态 图 : Y$) 
self.axes.set_xlabel(' 静 态 图 : XH 
self.axes.grid(True) 
定义 绘制 动态 图 函数 ， 设 置 每 隔 1 秒 就 会 重新 绘制 一 次 图 像 。 注 
意 ， 对 于 update_figure() 函 数 也 可 以 随意 定义 。 


' 1! 启动 绘制 动态 图 ''，' 
def start dynamic plot (self, *args, **kwargs): 
timer = QtCore.QTimer (self) 
timer.timeout.connect (self.update figure) # 每 隔 一 段 时 间 就 会 触发 
—kK update figure() BX, 
timer.start(1000) # 触发 的 时 间 间 隔 为 1 秒 


17 可 以 在 这 里 修改 动态 图 的 绘图 遇 辑 ' 
def update figure({self): 
self.fig.suptitle(' 测 试 动态 图 ') 


1 = [random.randint(0, 10) for i in range(4) ] 
selp axes plot Or Ll; 2 Sl, Ln te) 
self.axes.set ylabel(' 动 态 图 : Y 轴 ') 
self.axes.set xlabel(' 动 态 图 : X 轴 ') 
self.axes.grid (True) 

self.draw() 


2. 封 装 绘图 类 

这 部 分 主要 是 使 用 QWidget ”把 上 面 的 绘图 类 和 工具 栏 封装 到 
MatplotlibWidget 中 ， 我 们 只 需 调用 MatplotlibWidget 这 个 类 就 可 以 实现 
绘图 功能 

这 个 示例 保留 了 初始 化 时 就 载 入 图 像 的 接口 ， 把 下 面 注释 掉 的 代码 


取消 注释 ， 那 么 在 载 入 MatplotlibWidget 时 就 会 实现 绘图 功能 。 其 主要 
适用 于 那些 不 需要 使 用 按钮 来 触发 绘图 功能 的 场景 。 


class MatplotlibWidget (QWidget): 
def init (self, parent=None) : 
super (MatplotlibWidget, self). init (parent) 
self.inituUi () 


def initUi(self): 

self.layout = QVBoxLayout (self) 

self.mpl = MyMplCanvas (self, width=5, height=4, dpi=100, 
title='Title 1') 

# self.mpl.start_static plot() # 如 果 想 要 在 初始 化 时 就 呈现 静态 图 ， 请 取 
消 这 行 注 释 

# self.mpl.start dynamic plot() # 如 果 想 要 在 初始 化 时 就 呈现 动态 图 ,请 
取消 这 行 注释 

self.mpl ntb = NavigationToolbar(self.mpl, self)# 添加 完整 的 工具 栏 


self.layout.addWidget (self.mp1) 
self.layout.addWidget (self.mpl_ntb) 


测试 程序 : 
if _name_=='_main_': 
app=QApplication(sys.argv) 
ui=MatplotlibWidget() 
ui.mpl.start_static_plot() # 测试 静态 图 效果 
# ui.mpl.start_dynamic_plotO # 测试 动态 图 效果 
ui.show() 


sys.exit(app.exec_()) 
结果 如 图 9-29 所 示 ， 可 以 看 到 结果 符合 预期 。 





| E) python 一 口 x 
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和 9.3.3 节 一 样 ， 本 节 也 是 通过 Qt Designer 这 个 简单 而 又 强大 的 工 
有 具 来 实现 Matplotlib 与 PyQt 的 结合 的 。 

本 例 使 用 Qt Designer 生 成 的 窗口 文件 名 为 
PyQt5/Chapter09/matplotlib_pyqt.ui。 

首先 新 建 一 个 QWidget 类 ， 并 按照 图 9-30 所 示 设 置 提 升 的 窗口 控 
件 。 





新 建 提升 的 类 
基 类 名 称 : QWidget 添加 


提升 的 类 名 称 : MatplotlibWidget = MatplotlibWidget = ibWidget g2 
头 文件 : MatplotlibWidget 


全 局 包含 E 
提升 Close 


图 9-30 





然后 对 窗口 进行 布局 与 设置 ， 如 图 9-31 所 示 。 注 意 ， 这 两 个 
QWidget 都 是 提升 的 窗口 控件 。 


图 9-31 


最 后 ， 使 用 Eric 编 译 窗口 ， 并 设置 生成 button.click 的 对 话 框 代码 
《或 通过 其 他 方式 设置 相应 的 信和 号 与 槽 ) 。 
注意 
在 生成 对 话 框 代码 时 ， 可 能 会 提示 错误 : 模型 对 象 没 有 
MatplotlibWidget。 原 因 是 Eric 没有 找到 MatplotlibWidget.py 所 在 的 目 
录 ， 解 决 办 法 是 把 MatplotlibWidget.py 文 件 所 在 的 目录 添加 到 环境 变量 
中 ， 然 后 重启 即 可 。 


9.4.3 MatplotlibWidget 的 使 用 


首先 是 初始 化 模型 。 注 意 ， 在 初始 化 过 程 中 隐藏 了 两 个 图 像 ， 如 果 
想 让 它们 在 初始 化 时 就 呈现 的 话 ， 把 下 面 代码 中 的 最 后 两 行 注释 掉 就 可 
以 了 《和 见 matplotlib_pyqt.py 文 件 ) 。 
class MainWindow(QMainWindow, Ui_MainWindow): 


def __init__(self,parent=None): 





super(MainWindow, self). _init_ (parent) 
self.setupUi(self) 
self.matplotlibwidget_dynamic.setVisible(False) 
self.matplotlibwidget_static.setVisible(False) 
然后 设置 按钮 的 触发 操作 一 一 使 得 隐藏 的 图 像 可 见 ， 并 触发 对 应 的 
绘图 函数 。 
@pyatslot() 
def on_pushButton_clicked(self): 


TITTTTT 


Slot documentation goes here. 
self.matplotlibwidget_static.set Visible(True) 
self.matplotlibwidget_static.mpl.start_static_plot() 


@pyatslot() 
def on_pushButton_2_clicked(self): 


TITTTTT 


Slot documentation goes here. 


LAERE] 


self.matplotlibwidget_dynamic.setVisible(True) 
self.matplotlibwidget_dynamic.mpl.start_dynamic_plot() 


测试 程序 : 


if name == 


_ main ": 
import sys 
app=QApplication(sys.argv) 
ui=MainWindow() 
ui.show() 
sys.exit(app.exec_()) 

结果 如 图 9-32 所 示 ， 可 以 看 到 一 个 是 静态 图 ， 一 个 是 动态 图 ， 和 预 

期 的 一 致 。 


| MainWindow = 口 x 
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图 9-32 


人 至此， 对 Matplotlib 和 PyQt 结 合 的 使 用 方法 就 介绍 完了 。 通 过 上 述 
方法 ， 可 以 轻松 地 进行 图 像 绘制 ， 而 不 必 从 底层 实现 PyQt 的 绘图 功能 。 


9.4.4 更 多 扩展 


可 以 从 http://matplotlib.org/gallery.html 网 站 获取 Matplotlib 的 更 多 
示例 〈 如 图 9-33 所 示 ) ， 并 根据 这 些 示 例 代 码 修改 MyMplCanvas 类 ， 实 
现 PyQt 与 Matplotlib 更 多 种 类 的 绘图 交互 。 


os aes E t a matplotlib.org t & 


tefl pede P TY LES 


图 9-33 


9.5 PyOtGraph¢_PyQt'# HY) Dy. 


PyQtGraph 是 纯 Python 图 形 GUI 库 ， 它 充分 利用 PyQt 和 了 PySide 的 高 质 
量 的 图 形 表现 水 平和 NumpPy 的 快速 的 科学 计算 与 处 理 能 力 ， 在 数学 、 科 
学 和 工程 领域 都 有 广泛 的 应 用 。PyQtGraph 是 免费 的 ， 并 且 是 在 MIT 的 
开源 许可 下 发 布 的 。PyQtGraph 的 主要 目标 是 : 

e 为 数据 、 绘 图 、 视 频 等 提供 快速 、 可 交互 的 图 形 显 示 。 

e 提供 快速 开发 应 用 的 工具 。 

尽管 目前 PyQtGraph 还 没有 Matplotlib 成 熟 ， 但 是 PyQtGraph 比 
Matplotlib 要 快 得 多 ， 尤 其 是 在 显示 时 间 序 列 的 实时 行情 图 时 ， 
Matplotlib 在 性 能 上 有 些 捉 襟 见 肘 。 这 是 本 书 介 绍 PyQtGraph 的 一 个 重要 
原因 ， 男 一 个 重要 原因 是 PyQtGraph 有 自己 的 特殊 应 用 ， 如 图 形 交 互 、 
参数 树 、 流 程 图 等 。 由 于 PyQtGraph 是 基于 PyQt 开 发 的 集成 绘图 模块 ， 
所 以 使 用 PyQtGraph 绘 图 与 通过 底层 方式 来 实现 PyQt 的 绘图 功能 在 速度 
上 没有 太 大 的 区 别 。 


9.5.1 PyQtGraph 的 安 闭 
安装 PyQtGraph 最 简单 的 方法 就 是 使 用 pip 命 令 。 
pip install pyqtgraph 
9.5.2 官方 示例 解读 


使 用 PyQtGraph 的 一 个 好 处 是 通过 两 行 代码 就 可 以 看 到 所 有 官方 示 
例 。 




















import pyqtgraph.examples 


题 ， 


pygqtgraph.examples.run() 











通过 这 两 行 代码 就 可 以 弹出 一 个 窗口 ， 窗 口 左 侧 显示 的 是 示例 标 


右 侧 显 示 的 是 对 应 的 代码 ， 非 常 直观， 如 图 9-34 所 示 。 





E) pythonw 





Y GraphicsItems 


Command-line usage _ 


> 


E: \WWyPython\WinPython-64bit—3. 5. 3. 00t5\python-3. 5. 3. and64\1Lib\site—packages\pyatgraph\examples\Plotting. py 


= 口 x 





Basic Plotting 
ImageView 
ParaneterTree 
Crosshair / Mouse is 
Data Slicing 

Plot Customization 
Image Analysis 

Dock widgets 


# -k- coding: utf-6 -一 
This example demonstrates many of the 2D plotting capabilities 


in pyqtgraph. All of the plots may be panned/scaled by dragging with 
the left/right mouse buttons. Right click on any plot to show a context menu. 


import initExample ## Add path to library (just for examples; you do not need this) 


Console 

Histograms 

sore from pyqtgraph, Qt import QtGui, QtCore 
Auto-renge import numpy as np 


. i t pyateraph 
Remote Plotting SARO Ree OSE Be 


Scrolling plots #QtGui. QApplication. setGraphicsSystem(’ raster’ ) 


PA MMe data app = QtGui. QApplication([]) 
e #mw = QtGui. MainWindow() 
Optics 


dd relativity #mw, resi ze (800, 800) 


Verlet chain win = pg. GraphicsWindow(title="Basic plotting examples”) 


win, resize(1000, 600) 


Scatter Plot win, setWindowTitle(’ pyqtgraph example: Plotting ) 


Isocurveltem 
SEaren, 时 # Enable antialiasing for prettier plots 
i pg. setConfi gOptions(antialias=True) 


ieneslion a vides Y||pl = win. addPlot(title="Basic array plotting”, y=np. random. normal (size=100)) 





Qt Library: default 7 || po = win. addPlot(title="Multiple curves”) 
Graphics System: default v 


p2. plot (np. random. normal (size=100), pen=(255,0,0), name= Red curve”) 
p2. plot(np. random. normal (size=110)+5, pen=(0, 255,0), name="Green curve”) 


p2. plot (np. random. normal (size=120)+10, pen=(0, 0,255), name="Blue curve”) 
Run Example 





A 











| 


图 9-34 


比如 单 击 “Basic Plotting”, 
系列 优美 图 像 的 集合 ， 如 图 9-35 所 示 。 


然后 单 击 “Run Example” 按 钮 ， 就 会 看 到 





图 9-35 


我 们 以 第 一 个 图 为 例 ， 其 核心 代码 如 下 : 

import pyqtgraph as pg 
Import numpy as np 
win=pg.GraphicsWindow(title="Basic plotting examples") 
p1=win.addPlot(title="Basic array plotting", 

y=np.random. T 

ZEAE AJR A a SEA ST RRT AAA Qt 

Designer 来 实现 这 些 代码 。 





和 前 面 所 讲 的 一 样 ， 将 两 个 QWidget 窗 口 控件 拖 动 到 主 窗口 中 ， 然 
后 对 提升 的 窗口 控 进 行 设置 ， 如 图 9-36 所 示 。 








P 提升 的 窗口 部 件 - Qt Designer x f 

提升 的 类 

名 称 头 文件 。 全 局 包含 用 法 | | 

v QWidget 
GraphicsLayoutWidget pyqtgraph [_] | 

















图 9-36 


将 它们 分 别 重 命 名 为 pyqtgraphl 和 pyqtgraph2， 然 后 对 窗口 进行 布 


.为 减轻 阅读 负担 ， 这 里 直接 给 出 运行 结果 ， 如 图 9-37 所 示 。 
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图 9-37 


可 以 看 到 ， 图 片 背景 变 成 和 窗口 的 背景 色 一 样 了 。 接 下 来 会 详解 其 
中 的 设置 。 


9.5.4 PyQOtGraph H 





首先 对 程序 进行 初始 化 设置 (这 部 分 代码 见 pyqtgraph_pyqt.py 文 
件 ) 。 
import pydtgraph as pg 
class MainWindow(QMainWindow, Ui_MainWindow): 


def __init__(self,parent=None): 


super(MainWindow ,self)._ init (parent) 

pg.setConfigOption(‘background','#f0f0f0') # 设置 背景 色 为 灰 
色 

pg.setConfigOption(foreground','d') # 设置 前 景 分 (包括 坐标 
轴 、 线 条 、 文 本 等 ) 为 黑色 。 

pg.setConfigOptions(antialias=True) # 使 曲线 看 起 来 更 光滑 ， 
而 不 是 呈 锯 齿 状 

# pg.setConfigOption('antialias',True) # 等 价 于 上 一 条 语句 ， 不 
同 之 处 在 于 setConfigOptions 可 以 传递 多 个 参数 进行 多 项 设置 ， 而 
setConfigOption 一 次 只 能 接收 一 个 参数 进行 一 项 设置 

self.setupUi(self) 
这 里 需要 详细 说 明 如 下 两 点 。 

(1) 对 pg 的 设置 要 放 在 主 程序 初始 化 设置 self.setupUi(self) 之 前 ， 
否则 效果 呈现 不 出 来 ， 因 为 在 setuiUi0 函 数 中 己 经 按照 默认 方式 设置 好 
了 绘图 的 背景 色 、 文 本 颜色 、 线 条 颜色 等 。 

(2) 关于 获取 主 窗口 背景 色 ， 有 一 个 简单 的 方法 : 在 Qt Designer 
的 样式 编辑 器 中 随意 进入 一 个 颜色 设置 界面 ， 找 到 取 色 器 ， 单 击 “Pick 
Screen Color” 按钮， 对 主 窗口 取 色 〈 这 里 结果 为 #ft0fof0) ， 然 后 把 这 个 
结果 设置 为 PyQtGraph 的 背景 色 即 可 ， 如 图 9-38 所 示 。 
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图 9-38 


接 下 来 对 绘图 部 分 进行 介绍 。 


@pygqtSlot () 


def on _pushButton clicked(self): 
self.pyqtgraphl.clear() # 清空 里 面 的 内 容 ， 否 则 会 发 生 重复 绘图 的 结果 


' 第 一 种 绘图 方式 ' 页 
self.pyqtgraphl.addPlot (title=" 绘 制 单条 线 "， 


y=np.random.normal (size=100), pen=pg.mkPen (color='b', width=2)) 


a ' 第 二 种 绘图 方式 ' 11 
plt2 = Self.pydtographl.addPplot (title=" 绘 制 多 条 线 '") 


plt2.plot (np.random.normal (size=150), pen=pg.mkPen(color='r', 


width=2), name="Red curve") # pg.mkPen 的 使 用 方法 ， 设 置 线条 颜色 为 红色 ， 宽 度 为 2 
plt2.plot (np.random.normal (size=110) + 5, pen=(0, 255, 0), 


name="Green curve") 
plt2.plot (np.random.normal (size=120) + 10, pen=(0, 0, 255), 


name="Blue curve") 








第 一 个 按钮 要 处 理 的 是 如 何在 一 行 显示 两 个 图 。 可 以 看 到 ， 
PyQtGraph 的 绘图 方法 是 非常 通俗 易 懂 的 ， 通 过 addPlot 函 数 在 水 平方 向 
上 添加 了 一 个 图 。 

值得 说 明 的 是 ，pg.mkPen 函 数 是 对 Qt 的 QPen 类 的 简化 封装 ， 调 用 
时 只 需 传递 几 个 字典 参数 就 可 以 了 。 它 的 具体 使 用 方法 可 以 参考 官方 的 
帮助 文档 : 


http://www.pyqtgraph.org/documentation/functions.html#pyqtgraph.mkColor 


@pyqtSlot () 
def on_pushButton 2 clicked(self): 


Slot documentation goes here. 


75 如果 没 有 进行 第 一 次 绘图 ， 就 开始 绘图 ， 然 后 做 绘图 标记 ， 否 则 就 什么 都 不 做 
try: 
self.first_plot_flag # 检测 是 否 进 行 过 绘图 


except: 


plt = self.pyqtgraph2.addPlot (title=' 绘 制 条 状 图 ') 
x = np.arange (10) 


= np.sin(x) 


< 
上 一 
| 


v2 1 1 ep saan (ec) 
y3 = RSL (Z + 2) 


bgl = pg.BarGraphItem(x=x, height=yl, width=0.3, brush='r') 
bg2 = pg. BarGraphItem(x=x + 0.33, height=y2, width=0.3, brush='g') 
bg3 = pg.BarGraphItem(x=x + 0.66, height=y3, width=0.3, brush='b') 


plt.addItem(bg1) 
plt.addItem(bg2) 
plt.addItem(bg3) 


self.pyqtgraph2.nextRow () 


p4 = self.pyqtgraph2.addPlot (title=" 参 数 图 + 显示 网 格 ") 
x = np.cos(np.linspace(0, 2 * np.pi, 1000)) 

y = np.sin(np.linspace(0, 4 = np.pi, 1000) ) 
p4.plot(x, y, pen=pg.mkPen(color='d', width=2) ) 


p4.showGrid(x=True, y=True) # 显示 网 格 


self.first_plot_flag = True # 第 一 次 绘图 后 进行 标记 


第 二 个 按钮 要 处 理 的 是 如 何在 一 列 绘制 两 个 图 。 关 键 代码 如 下 : 
self.pyqtgraph2.nextRow() 
表示 从 下 一 行 开 始 绘图 ， 这 在 逻辑 上 是 很 容易 理解 的 。 





注意 

这 里 没有 使 用 self.pyqtgraph2.clear0 函数， 而 是 使 用 try 语 句 ， 是 
为 在 垂直 方 同 上 进行 绘图 ， 使 用 这 个 函数 会 出 现 问 题 ， 具 体会 出 现 什么 
问题 读者 可 以 自己 去 尝试 。 这 个 问题 应 该 是 官方 原因 ， 没 有 把 这 个 函数 
处 理 完善 ， 暂 时 也 找 不 到 其 他 的 能 够 解决 这 个 问题 的 函数 ， 因 此 使 用 try 
语句 是 一 种 无 条 的 选择 。 

同时 ， 我 们 可 以 看 到 PyQtGraph 绘 图 所 使 用 的 数据 绝 大 部 分 是 用 
NumPy 生 成 的 ， 这 也 从 侧面 说 明了 PyQtGraph 的 确 是 基于 PyQt 和 NumPy 
FAHY © 

本 节 对 使 用 PyQtGraph 与 PyQt 结 合 绘图 进行 了 人 介绍， 虽然 例 子 不 
多 ， 但 是 内 容 却 很 丰富 ， 读 者 可 以 根据 需求 ， 轻 松 地 把 官方 示例 快速 应 
用 到 自己 的 程序 中 。 








9.5.5 更 多 扩展 


如 前 所 述 ， 运 行 下 面 的 代码 将 获取 所 有 官方 示例 ， 找 到 相应 的 示例 
代码 对 本 节 的 例子 进行 修改 ， 完 成 扩展 。 
import pyqtgraph.examples 








pyqtgraph.examples.run() 


9.6 Plotly Œ PyQt HI Dy. 


Plotly 本 质 上 是 基于 JavaScript 的 图 表 库 ， 文 持 不 同类 型 的 图 表 ， 如 
地 图 、 箱 形 图 、 密 度 图 ， 以 及 比较 常见 的 条 状 图 和 线形 图 等 。 从 2015 年 
11 月 17 日 开始 ，Plotly 个 人 版 本 可 以 免费 使 用 了 。 

Plotly 一 经 问世 就 得 到 了 快速 发 展 ， 特 别 是 开源 之 后 ， 导 致 其 服务 
器 的 发 展 跟 不 上 用 户 数量 的 增长 ， 因 此 使 用 在 线 版 本 的 Plotly 绘 图 会 有 
些 卡 。 幸 运 的 是 ，plotly.js 已 经 开源 ， 我 们 可 以 使 用 离线 版 本 的 Plotly， 
不 但 绘图 速度 快 ， 而 且 效 果 和 在 线 版 本 没什么 不 同 。 因 此 ， 本 节 将 以 离 
线 版 本 为 例 来 进行 介绍 。 

除了 Python，Plotly 对 JavaScript、R、MATLAB 也 都 有 很 好 的 支 
持 ， 而 且 绘 图 效果 一 样 ， 也 就 是 说 ， 它 的 跨 平 台 性 非常 强 。 这 也 是 
Plotly 的 优势 之 一 。 

本 节 主 要 介绍 Plotly 在 PyQt 中 的 应 用 ， 因 此 不 会 对 Plotly 的 基础 知识 
做 过 多 的 介绍 ， 但 是 会 给 出 一 些 经 典 示 例 ( 如 果 你 想 了 解 Plotly 的 更 多 
内 容 ， 请 参考 https://plot.ly/python/)。 


9.6.1 Plotly 的 安装 


安装 Plotly 最 简单 的 方法 就 是 使 用 pip 命 令 。 
pip install plotly 


9.6.2 示例 解读 


在 打算 把 Plotly 柑 入 到 GUI 开 发 中 之 前 ， 笔 者 一 直 想 要 在 Plotly 官 网 
中 找到 相关 的 线索 ， 遗 憾 的 是 ， 在 Plotly 的 帮助 文档 中 并 没有 找到 与 


PyQt 结 合 使 用 的 具体 方法 。 经 过 笔者 的 实践 ， 发 现 可 以 通过 PyQt 的 
QWebEngineView 类 封装 Plotly 所 生成 的 绘图 结果 ， 从 而 实现 Plotly 与 
PyQt 的 交互 。 

这 里 使 用 了 QWebEngineView 类 ， 这 个 类 从 PyQt ”5.7 版 本 才 开 始 引 
入 。 引 入 这 个 类 的 最 主要 原因 是 在 PyQt 5.6 及 以 前 版 本 中 使 用 的 是 
QWebView 类 ，QWebView 使 用 的 是 目 己 开 发 维护 的 WebKit 内 核 ， 这 个 
内 核 比 较 陈 旧 ， 对 JavaScript 的 一 些 新 生 事 物 〈( 如 Plotly〉 的 支持 性 不 
好 。 而 QWebEngineView 使 用 的 是 Chromium 内 核 ， 利 用 Chrome 浏览 器 
的 优势 可 以 完美 解决 其 兼容 性 问题 。 但 是 QWebEngineView 有 一 个 比较 
大 的 缺点 ， 就 是 启动 速度 比较 慢 ， 相 信和 在 日 后 的 发 展 中 ，PyQt 团 队 会 慢 
慢 解 决 这 个 问题 。 

需要 提醒 的 是 ， 这 里 的 示例 使 用 的 是 PyQt ”5.7 及 以 后 版 本 ，9.6.6 
节 “Plotly 与 PyQRt 5.6 的 结合 ”会 给 出 使 用 PyQt 5.6 及 以 前 版 本 与 Plotly 进 行 
间接 交互 的 方法 ， 不 过 其 支持 的 图 表 会 有 限制 。 

QWebEngineView 与 Plotly 交 互 非常 简单 ， 本 例文 件 名 为 
PyQt5/Chapter09/demo_plotly_pyqt.py， 详 细 代 码 如 下 : 














t = = coding: tE- =t- 


Module implementing MainWindow. 


from PyQt5.QtCore import * 

from PyQt5.QtGui import * 

from PyOt5.QtWidgets import * 

import sys 

from PyOt5.QtWebEngineWidgets import QWebEngineView 


class Window (QWidget): 
def init (self): 
QWidget. init (self) 
self.qwebengine = QWebEngineView (self) 
self.qwebengine.setGeometry(QRect (50, 20, 1200, 600)) 
self.qwebengine.load(QUrl.fromLocalFile('\plotly html\if hs300 bais.h 
E 


app = QApplication(sys.argv) 
screen = Window() 
screen. showMaximized () 


sys.exit(app.exec ()) 


其 核心 代码 如 下 : 
self.qwebengine=QWebEngineView(self) 
self.qwebengine.load(QUrl.fromLocalFile(‘\plotly_html\if_hs300_bais 
tml')) 
表示 新 建 一 个 QWebEngineView， 以 及 在 QWebEngineView 中 载 入 
文件 。 
请 注意 ，if_hs300_bais.html 是 用 Plotly 生 成 的 HTML 本 地 文件 。 我 们 
会 在 后 面 介绍 如 何 利 用 代码 生成 这 个 文件 。 我 们 先 看 一 下 程序 运行 结 
果 ， 如 图 9-39 所 示 。 





图 9-39 





可 以 看 到 ， 这 个 图 非常 漂亮 ， 可 以 动态 显示 当前 时 间 点 的 价格 。 在 
Plotly 的 绘图 结果 中 也 可 以 找到 一 些 其 他 好 玩 的 方法 ， 依 次 单 击 右 上 和 角 
的 几 个 按钮 就 可 以 发 现 这 些 方法 。 此 外 ， 若 想 查 看 区 间 图 ， 可 以 按 住 鼠 
标 左 键 疝 右 拖 动 ， 如 图 9-40 所 示 。 

如 有 果 要 恢复 为 初始 图 的 样子 ， 则 单 击 右 上 和 角 的 “autoscale” 按 钮 即 
A. 








if_hs300_bais 














图 9-40 
AJ ay » 
9.6.3 v a Jh 口 控 


由 于 Qt Designer 没 有 直接 提供 QWebEngineView 类 ， 所 以 需要 通过 
提升 的 窗口 控件 来 间接 提供 这 个 类 。 

和 前 面 介绍 的 一 样 ， 将 两 个 QWidget 窗 口 控件 拖 动 到 主 窗口 中 ， 对 
提升 的 窗口 控件 进行 设置 ， 如 图 9-41 所 示 。 


D 提升 的 窗口 部 件 - Qt Designer 
提升 的 类 


oe 头 文 件 2882 用 法 
v QWidget 
QWebEngineView PyQt5.QtWebEngineWidgets 

















图 9-41 
9.6.4 Plotly PyQt5H 


前 面 我 们 已 经 看 到 ，QWebEngineView 只 需 接 受 Plotly 生 成 的 HTML 
文件 路 径 就 可 以 实现 PyQt 5 与 Plotly 的 交互 ， 因 此 这 个 示例 的 主要 作用 就 
是 通过 Plotly 生 成 HIML 本 地 文件 ， 并 返回 该 HTML 文件 路 径 《〈 代 码 见 
Plotly_PyQt5.py 文 件 ) 。 


) 


data = [line hs300 close,line main price] 


layout = dict (title="1t hs300 bais', 
xaxis=dict (title='"Date'), 


yaxis=dict (title='Price'), 


) 
fig = go.Figure(data=data, layout=layout) 


pyof.plot(fig, filename=path plotly, auto open=False) 
return path plotly 


对 于 这 个 示例 ， 需 要 注意 的 是 : 
(1) 文件 绘图 使 用 的 是 离线 绘图 模式 ， 而 不 是 在 线 绘图 模式 。 
为 离线 绘图 模式 的 速度 非常 快 ， 而 在 线 绘图 模式 由 于 对 方 服务 器 的 原 
会 比较 卡 。 
import plotly.offline as pyof 
(2) 禁止 目 动 在 浏览 器 中 打开 。 设 置 auto_open 参 数 为 False。 
pyof.plot(fig,filename=path_plotly,auto_open=False) 
(3) 绘图 完成 后 将 绘图 结果 保存 在 本 地 ， 通 过 函数 返回 保存 的 路 
径 ， 然 后 让 QWebEngineView 调 用 这 个 路 径 就 实现 了 PyQt 与 Plotly 的 交 
ie 
return path_plotly 
对 于 PyQt 的 主 程序 ， 代 码 如 下 《〈 见 plotly_pyqt.py 文 件 ) : 


from Plotly PyQt5 import Plotly PyQt5 


class MainWindow(QMainWindow, Ui MainWindow) : 


Class documentation goes here. 


woe 


def imit (self; parent None): 


woe 


Constructor 


@param parent reference to the parent widget 
@type QWidget 
super (MainWindow, self). init (parent) 
self.setupUi (self) 
self plotly pyqgt5 = Plotly Pyots() 
self.qwebengine.setGeometry (QRect (50, 20, 1200, 600)) 
self.qwebengine. load (QUrl.fromLocalFile ( 
self.plotly pyqt5.get plotly path if hs300 bais())) 





app = QApplication(sys.argv) 
win = MainWindow() 
win.showMaximized() 


app.exec_() 


其 核心 代码 如 下 : 
self.plotly_pyqt5=Plotly_PyQt5() 
self.qwebengine.setGeometry(QRect(50,20, 1200,600)) 
self.qwebengine.load(QUrl.fromLocalFile(self.plotly_pyqt5.get_plotly 
这 几 行 代码 的 作用 类 似 于 前 面 提 到 的 代码 : 
self.qwebengine.load(QUrl.fromLocalFile(‘\if_hs300_bais.html’)) 
运行 结果 如 图 9-42 所 示 ， 和 图 9-39 所 示 的 结果 没什么 不 同 。 
注意 


这 里 使 用 很 笨 的 方法 ， 首 先 从 Ploty 中 绘图 ， 把 结果 保存 到 本 地 ， 


然后 通过 QWebEngineView 加 载 这 个 本 地 文件 。 这 样 就 产生 了 以 人 硬盘 写 
入 与 读 取 的 问题 ， 显 然 会 拖 慢 程序 的 运行 速度 

针对 这 个 问题 ， 笔 者 也 曾经 尝试 过 直接 通过 QWebEngineView Kini 
染 Plotly 生 成 的 JavaScript 代 码 ( 见 PyQt_plotly_js.py 文 件 ) ， 但 是 遗憾 的 
是 ， 没 有 成 功 ， 原 因 是 QWebEngineView 对 于 太 大 的 JavaScript 不 能 很 好 
地 支持 ， 这 个 属于 PyQt5 的 Bug， 希望 日 后 这 个 问题 能 够 完美 地 解决 。 
所 以 本 章 提 供 的 解决 方案 虽然 不 是 最 完美 的 ， 但 却 是 目前 笔者 所 知道 的 
最 好 的 方案 。 
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图 9-42 
9.6.5 更 多 扩展 


这 里 仅仅 展示 了 Ploty 的 一 个 示例 ， 如 果 你 需要 了 解 更 多 的 示例 ， 
可 以 访问 https://plot.ly/python/， 如 图 9-43 所 示 。 
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图 9-43 











你 需要 做 的 仅仅 是 对 相关 例子 的 代码 进行 修改 ， 并 修改 
get_plotly_path_if hs300_bais 函 数 ， 使 之 文 持 你 要 实现 的 绘图 结果 。 就 
是 这 么 简单 。 





9.6.6 Plotly 与 PyQt 5.6 的 结合 


由 于 Plotly 所 采用 的 JavaScript 框 架 比 较 新 ，PyQt 5.6 及 以 前 版 本 对 它 
的 支持 性 不 是 很 好 。 笔 者 经 过 不 断 摸 索 ， 找 到 了 一 种 QWebView 文 持 
Plotly 的 间接 方案 一 一 就 是 先 用 Matplotlib 进 行 绘图 ， 然 后 用 Plotly 泻 染 
结果 ， 最 后 使 之 与 QWebView 进 行 结 合 。 在 所 有 的 公开 信息 中 ， 本 书 应 
该 是 第 一 个 给 出 这 种 解决 方案 的 ， 在 这 之 前 还 没有 见 到 能 够 实现 PyQt 
5.6 及 以 前 版 本 与 Plotly 进 行 交 互 的 案例 。 

既然 这 种 方案 可 以 解决 PyQt 与 Plotly 进 行 交互 的 问题 ， 那 么 为 什么 
不 采用 这 种 方案 呢 ? 原因 有 三 点 。 











(1) 这 种 方案 严重 依赖 Matplotlib 的 图 表 库 ， 如 果 有 些 图 表 
Matplotlib 无 法 实现 ， 那 么 Plotly 也 了 吏 无 法 对 其 进行 泻 染 了 。 也 了 吏 是 说 ， 

对 于 一 些 Plotly 拥 有 而 Matplotlib 却 没有 的 图 表 ， 该 方案 无 能 为 力 。 

(2) 这 种 方案 所 泻 染 的 Plotly 图 表 与 Plotly 的 原生 图 表 在 外 观 上 
有 一 些 不 同 ，Plotly 的 原生 图 表 相 对 比较 好 看 些 。 

(3) 有些 自 定义 的 Matplotlib 图 表 无 法 通过 Plotly 进行 泻 染 ， 笔 者 
经 对 双 坐 标 轴 的 Matplotlib 图 表 进 行 Plotly 泻 染 ， 但 是 无 论 如 何 都 没有 
结果 。 可 见 ， 使 用 Plotly 演 染 Matplotlib 图 表 的 兼容 性 还 有 待 提高 。 

接 下 来 介绍 如 何 使 用 QWebView 和 了 Plotly 进 行 交 互 。 幸 运 的 是 ，Qt 
Designer 默 认 提 供 了 QWebView 类 ， 上 所 以 在 此 就 不 用 设置 提升 的 窗口 控 
件 了 。 其 使 用 方法 如 下 : 

在 Qt Designer 界 面 左 侧 的 “Display Widgets” 导 航 栏 中 选中 
QWebView 并 拖 动 到 主 窗口 中 ， 结 果 如 图 9-44 所 示 。 
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图 9-44 


下 面 给 出 示例 。 特 别提 示 : 这 个 示例 需要 在 PyQt 5.6 及 以 前 版 本 中 
运行 ， 需 要 读者 上 自行 配置 相应 的 PyQt 环 境 《代码 见 





plotly_matplotlib_pyqt.py 文 件 ) 。 


win.showMaximized() 


app.exec () 


其 核心 代码 如 下 : 
self.plotly_pyqt5=Plotly_PyQt5() 
self. webView.setGeometry(QRect(50,20,1200,600)) 
self.webView.load(QUrl.fromLocalFile(self.plotly_pyqt5.get_plot_pat 
在 这 里 ，QWebView 的 使 用 方法 和 前 面 介绍 的 QWebEngineView 的 
使 用 方法 一 致 ， 把 最 重要 的 结果 封装 到 Plotly_PyQt5 类 的 
get_plot_path_matplotlib_plotly 函 数 中 。 下 面 看 一 下 这 个 函数 的 使 用 方 
we 





def get plot path matplotlib plotly(self, 
file name='matplotlib plotly.html"'): 
path plotly = self.path dir plotly html + os.sep + file name 


N 50 

x = np.random.rand(N) 

y = np.random. rand (N) 

colors = np.random. rand (N) 

area =np.pi * (15 * np.random.rand(N)) ** 2 #0 to15 point radii 
scatter mpl fig = plt.figure() 


plt.scatter(x, y, s=area, c=colors, alpha=0.5) 


pyof.plot_mpl(scatter mpl fig, filename=path plotly, 
resize-True, auto open=False) 


return path plotly 





需要 注意 如 下 几 点 。 
C1) 这 个 示例 使 用 的 是 plot_ mpl 函 数 ， 而 不 是 plot 函 数 。plot_mpl 
的 作用 是 把 Matplotlib 形 式 的 绘图 结果 转换 成 Plotly 形 式 的 绘图 结果 。 
(2) 所 传递 的 第 一 个 参数 是 Matplotlib 图 表 ， 而 不 是 Plotly 生 成 的 图 








表 。 

(3) resize=True， 表 示人 允许 Plotly 重 新 定义 图 表 的 大 小 ， 默 认为 
False。 从 图 9-45 可 以 看 出 ， 绘 图 结果 的 尺寸 发 生 了 变化 。 

可 见 ， 我 们 实现 了 Plotly 对 Matplotlib 图 表 的 泻 染 并 且 修 改 了 原 有 
图 表 的 大 小 (默认 的 Matplotlib 图 表 不 会 有 这 么 大 的 宽度 ) 。 





图 9-45 


9.6.7 更 多 扩展 


可 以 从 http://matplotlib.org/gallery.html 网 站 获取 Matplotlib 的 示例 
(如 图 9-46 所 示 ) ， 并 修改 get_plot_path_matplotlib_ploty 函 数 ， 来 间接 
地 实现 PyQt (QWebView) 与 Plotly 的 交互 。 
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图 9-46 











一 般 来 说 ，UI 层 的 自动 化 测试 是 通过 工具 或 编写 脚本 的 方式 来 模拟 
手工 测试 的 过 程 ， 通 过 运行 脚本 来 执行 测试 用 例 ， 从 而 模拟 人 工 对 软件 
的 功能 进行 验证 。 

PyQt 是 Qt 框架 的 Python 语言 实现 ， 对 于 单元 测试 ，Python 可 以 使 用 
它 内 部 自 带 的 单元 测试 模块 unittest。 对 于 模拟 手工 操作 ，PyQt 可 以 使 
用 它 内 部 的 测试 模块 QTest。 本 市 将 结合 unittest 和 QTest 模 块 对 PyQt 5 应 
用 的 UI 窗口 进行 自动 化 测试 。 

注意 

虽然 Qt C++ API 包 含 了 完整 的 单元 测试 框架 ， 但 是 PyQt 的 QtTest 模 
块 仅 包含 QTest 类 ， 它 使 用 静态 方法 来 模拟 按键 、 鼠 标 单 击 和 鼠标 移 
动 。 








手工 测试 是 传统 、 常 规 的 软件 测试 方法 ， 由 测试 人 员 依 据 设 计 文 档 
手工 编写 测试 用 例 ， 然 后 执行 并 记录 测试 结果 。 对 于 手工 测试 ， 大 部 分 
测试 人 员 再 熟悉 不 过 了 ， 例 如 茶 个 测试 用 例 ， 是 在 页 面 中 输入 不 同 的 值 
反复 提交 一 个 表单 ， 对 查询 结果 进行 测试 ， 然 后 判断 查询 数据 是 否 符 合 
业务 逻辑 。 这 种 测试 方法 适用 于 测试 用 例 中 输入 项 比较 少 的 情况 ， 如 果 
需要 不 断 地 重复 某 个 测试 用 例 ， 例 如 不 断 地 重复 验证 用 户 登录 系统 
10000 次 后 ， 是 否 还 能 登录 系统 成 功 ， 那 么 手工 测试 就 会 很 宗 ， 这 个 时 
候 就 需要 使 用 自动 化 测试 来 模拟 手工 登录 系统 的 操作 ， 从 而 避免 重复 的 
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自动 化 测试 是 指 利 用 软件 测试 工具 自动 实现 全 部 或 者 部 分 测试 工作 
《测试 管理 、 测 试用 例 设计 、 测 试 执行 和 生成 测试 报告 ，》。 自 动 化 测试 
可 市 省 大 量 的 测试 资源 ， 并 能 够 完成 一 些 手工 测试 无 法 实现 的 测试 ， 比 
如 单元 测试 、 统 计 测 斌 覆盖 率 等 。 随 着 技术 的 进步 ， 又 发 展 出 UI 层 的 上 自 
动 化 测试 。 

UI 层 的 自动 化 测试 ， 是 自动 化 测试 的 一 类 ， 是 指 编写 代码 、 脚 本 ， 
通过 测试 框架 的 驱动 ， 让 脚本 自动 运行 ， 通 过 UI 层面 的 键盘 输入 和 鼠标 
操作 ， 发 现 被 测 系统 的 缺陷 ， 来 代 蔡 部 分 手工 测试 。 它 的 核心 思想 是 ， 
通过 测试 框架 抓 取 被 测 元 素 对 象 ， 保 存 至 对 象 库 ， 通 过 脚本 的 编写 以 及 
配置 必要 的 测试 数据 ， 在 被 测 系统 上 进行 回放 ， 张 动 被 测 系 统 完成 我 们 
期 望 的 操作 ， 获 得 最 终结 果 ， 并 将 最 终结 果 与 预 设 的 期 望 值 进行 比 对 ， 
将 比 对 结果 进行 报告 输出 。 

综 上 所 述 ， 手 工 测 试 和 自动 化 测试 的 特点 总 结 如 下 : 

(1) 手工 测试 由 人 手工 去 执行 测试 用 例 ; 上 自动 化 测试 由 程序 代 蔡 
人 去 执行 测试 用 例 。 

(2) 手工 测试 非常 消耗 时 间 ， 持 续 进 行 手工 测试 会 使 测试 人 员 感 
到 疲惫 ， 上 自动 化 测试 可 以 代 蔡 一 部 分 机 械 重 复 的 手工 测试 。 

(3) 手工 测试 永远 无 法 被 自动 化 测试 取代 。 在 整个 软件 开发 周期 
中 ， 手 工 测 试 发 现 Bug 所 占 的 比例 大 ， 大 约 为 80%; 而 自动 化 测试 只 能 
发 现 大 约 20% 的 Bug。 

(4) 手工 测试 适合 测试 业务 逻辑 ， 上 自动 化 测试 适合 进行 回归 测 
试 。 回 归 测 试用 于 测试 已 有 功能 ， 而 不 是 新 增 功 能 。 自 动 化 测试 有 利于 
测试 项 目 底层 的 细节 ， 比 如 可 以 测试 出 软件 的 朋 谈 、API 的 错误 返回 
值 、 业 务 逻 辑 异 常 和 软件 的 内 存 使 用 等 。 

由 于 PyQt 的 UI 自动 化 测试 用 例 比 较 少 ， 因 此 这 里 参考 了 国外 网 友 
John McGehee 编 写 的 测试 用 例 。 有 兴趣 的 读者 可 以 查看 原文 ， 地址 是 
http://johnnado.com/pyqt-qtest-example/。John McGehee 使 用 QtDesigner 设 











计 了 玛 格 丽 特 鸡 尾 酒 的 调 酒 器 窗口 界面 ， 采 用 的 PyQt 开 发 版 本 是 PyQt 
4， 笔 者 对 他 的 代码 进行 了 优化 ， 添 加 了 新 功能 ， 并 使 用 最 新 版 的 PyQt 
5 重 写 了 测试 用 例 。 在 此 向 John McGehee 表 示 感 谢 。 软 件 开发 就 是 这 样 
的 ，“ 赠 人 玫瑰 ， 手 有 余 香 ”， 原 作者 愿意 公开 源码 和 思路 ， 后 面 的 开发 
工程 师 才 可 以 根据 这 些 资料 ， 在 原 有 的 基础 上 开发 出 更 好 的 软件 。 

自动 化 测试 部 分 的 编写 要 感谢 HP 的 自动 化 测试 专家 楚 建 欣 ， 他 是 
中 国 国内 自动 化 测试 方面 的 专家 。4 年 前 我 们 一 起 在 IATA《 国 际 航 空运 
输 协会 )， 从 无 到 有 搭建 了 IATA 内 部 财务 系统 的 自动 化 测试 项 目 ， 使 
用 的 是 HP 的 自动 化 测试 工具 UFT (Unified Functional Testing) 。 楚 建 
欣 作为 自动 化 项 目的 技术 负责 人 ， 承 担 了 大 量 的 自动 化 工作 ， 虽 然 整 个 
技术 团队 只 有 我 们 两 个 人 ， 但 他 项 着 巨大 的 压力 攻克 了 很 多 技术 难点 ， 
无 私 地 教会 了 笔者 很 多 自动 化 测试 框架 的 精髓 ， 在 此 表示 感谢 。 在 经 过 
半年 多 的 努力 后 ，IATA 的 自动 化 测试 项 目 也 顺利 的 成 功 上 线 。 在 这 个 
过 程 中 ， 与 楚 大 哥 合作 得 非常 愉快 ， 谨 以 此 篇 纪念 我 们 曾经 一 起 战斗 过 
的 日 子 。 

在 下 一 节 中 ， 将 使 用 Qt Designer 制 作 一 个 模拟 调制 鸡尾酒 的 调 酒 器 
窗口 ， 然 后 使 用 Python 的 unittest 模 块 和 PyQt 5 的 QTest 模 块 对 调 酒 器 窗口 
进行 UI 层 的 自动 化 测试 。 

















图 9-47 


现实 生活 中 的 调制 玛 格 丽 特 鸡 尾 酒 的 机 器 如 图 9-47 所 示 。 

玛 格 丽 特 鸡 尾 酒 (Margarita Midori) 

原料 : 冰 块 8 粒 、Ei Charro Anejo 龙 舌 兰 酒 20 毫 升 、Midori 102271. 
新 鲜 柠 榜 汗 20 毫升 、Triple Sec 20 毫 升 、 细 盐 少许 。 

做 法 : 将 龙 舌 兰 酒 、 新 鲜 标 檬 并、Midori 和 Triple  Sec{#] AFA az 
中 ， 加 入 一 些 冰 块 ， 摇 勺 后 滤 入 挂 有 盐 霜 的 酒杯 中 ， 并 在 泡沫 上 撒 少 许 
细 盐 。 

按照 调 酒 方法 将 龙 舌 兰 酒 、 新 鲜 标 柑 汗 和 订 块 装 入 量 酒 峰 
Gigger) 中 ， 就 可 以 根据 量 酒 器 的 体积 〈 升 ) 推算 出 可 以 调制 出 来 的 
鸡尾酒 的 体积 〈 升 ) 了 。 因 为 不 同 液体 的 密度 是 不 一 样 的 ， 在 本 例 中 ， 
一 个 量 酒 器 可 以 容纳 0.0444 升 的 鸡尾酒 。 

一 个 量 酒 器 只 能 调配 出 一 杯 鸡尾酒 ， 而 调 酒 占 一 次 可 以 调制 出 多 杯 
鸡尾酒 。 

如 图 9-48 和 图 9-49 所 示 分 别 是 在 生活 中 使 用 的 量 酒 器 和 玛 格 丽 特 
鸡尾酒 的 成 品 ， 读 者 可 以 很 快 明白 量 酒 器 和 鸡尾酒 的 体积 关系 。 











图 9-48 





图 9-49 


PyQt Qtest 上 自动 化 测试 例子 中 各 个 文件 说 明 如 下 。 

e MargaritaMixer.ui, Qt Designer 的 XML 输出 ， 用 于 描述 GUI 对 话 框 
WU 

e MargaritaMixer.py， 用 于 描述 GUI 对 话 框 设计 的 Python 源 代码 文 
件 ， 可 以 使 用 如 下 命令 来 创建 窗口 的 .py 文件 。 

pyuic5-o MatrixWinUi.py MatrixWinUi.ui 

e CallMatrixWinUi.py， 包 含 了 实例 化 GUI 对 话 框 并 处 理 结果 的 类 。 

e MatrixWinTest.py， 自 动 化 单元 测试 。 

e RunTestCase.py， 进 行 自动 化 测试 ， 生 成 测试 报告 。 

以 上 文件 都 保存 在 PyQt5/Chapter03/testCase 目 录 下 。 读 者 可 以 按照 
目 己 的 想法 进行 修改 ， 测 试 代 码 的 履 盖 率 越 高 ， 软 件 的 质量 就 越 好 。 所 
以 编写 完 软件 后 ， 不 要 怕 腑 烦 ， 一 定 要 编写 测试 代码 ， 在 本 例 中 编写 了 
目 动 化 测试 代码 ， 使 用 测试 代码 来 模拟 人 工 执 行 测试 用 例 ， 提 高 了 代码 
测试 的 履 盖 率 ， 并 且 执 行 完 测试 用 例 后 会 自动 生成 测试 报告 。 

对 于 这 个 例子 ， 使 用 Qt Designer 来 设计 鸡尾酒 调 酒 器 窗口 ， 如 图 9- 


50 和 图 9-51 所 示 。 该 窗口 文件 名 为 MatrixWinUi.ui， 保 存在 
PyQt5/Chapter03/testCase 目 录 下 。 
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图 9-51 





在 窗口 上 部 ， 指 定 各 原料 的 量 酒 器 容量 (一 个 量 酒 器 为 0.0444 
升 ) 。 在 “9 种 搅拌 速度 ”部 分 ， 选 择 搅 拌 速度 。 选 定 原料 量 和 搅拌 速度 
后 ， 单 击 “Ok” 按 钮 ， 束 会 模拟 真实 机 器 调制 鸡尾酒 了 ， 并 把 结果 显示 在 
窗口 的 “操作 结果 ”部 分 。 单 击 “Clear” 按 钮 ， 会 清空 “操作 结果 ”部 分 的 提 
示 。 单 击 “Cancel” 按 钮 ， 会 关闭 调 酒 器 窗口 。 





这 里 对 窗口 中 的 控件 进行 简要 说 明 ， 如 表 9-6 所 示 。 


QScrollBar 


QLabel 
QSpinBox 
QLineEdit 
QSlider 


QRadioButton 
QRadioButton 
QRadioButton 
QRadioButton 
QRadioButton 
QRadioButton 
QRadioButton 
QRadioButton 
QRadioButton 
QPushButton 
QPushButton 
QPushButton 
QTextEdit 


selScrollBarLbl 
tripleSecSpinBox 
limeJuiceLineEdit 


iceHorizontalSlide 
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resultText 





429-6 
控件 类 型 控件 名 称 


tequilaScrollBar 


显示 龙 舌 兰 酒 的 滑动 条 ， 连 接 uiScrollBarValueChanged 函数 的 绑 定 。 触 发 控件 
信号 valueChanged 的 发 射 

显示 选择 导入 的 龙 舌 兰 酒 的 当前 值 

显示 三 重 蔡 馏 酒 的 文本 框 

显示 柠檬 汁 的 文本 框 

显示 冰 块 的 滑动 条 ， 连 接 uilceSliderValueChanged 函数 的 绑 定 。 触 发 控件 信和 号 
valueChanged 的 发 射 
显示 搅拌 速度 的 单 选 钮 ， 
显示 搅拌 速度 的 单 选 钮 ， 
显示 搅拌 速度 的 单 选 钮 ， 
显示 搅拌 速度 的 单 选 钮 ， 
显示 搅拌 速度 的 单 选 钮 ， 
示 搅 拌 速度 的 单 选 钮 ， 速 度 为 Beat 

示 搅 拌 速度 的 单 选 钮 ， 速 度 为 Smash 

显示 搅拌 速度 的 单 选 ， 速 度 为 Liquefy 

显示 搅拌 速度 的 单 选 钮 ， 速 度 为 Vaporize 

单 击 “OK” 按钮 ， 连 接 uiAccept 函数 的 绑 定 。 触 发 控件 信号 clicked 的 发 射 
单 击 “Clear” 按 钮 ， 连 接 uiClear 函数 的 绑 定 。 触 发 控件 信号 clicked 的 发 射 
单 击 “Cancel” 按 钮 ， 连 接 uiReject 函数 的 绑 定 。 触 发 控件 信号 clicked 的 发 射 
显示 所 调制 的 鸡尾酒 的 配置 结果 和 搅拌 速度 


速度 为 Whip 
速度 为 Puree 
速度 为 Chop 
速度 为 Karate Chop 





这 里 对 在 信号 / 模 编 辑 器 中 定义 的 信号 和 槽 进行 简要 六 明 ， 如 表 9-7 


所 示 。 


表 9-7 


BE ee) E ee E 


tequilaScrollBar valueChanged(int) uiScrollBarValueChanged() 


clicked() uiAccept() 
iceHorizontalSlider | valueChanged(int) uilceSliderValueChanged() 
clicked() uiClear() 


当 改 变 导 入 龙 舌 兰 酒 的 滑动 条 时 ， 发 射 这 个 
信号 


当 单 击 “OK ”按钮 时 ， 发 射 这 个 信和 号 
当 用 户 改 变 冰 块 滑 块 时 ， 发 射 这 个 信和 号 
当 用 户 单 击 “Clear” 按 钮 时 ， 发 射 这 个 信和 号 
当 用 户 单 击 “Cancel” 按 钮 时 ， 发 射 这 个 信和 号 





clicked() uiReject() 


9.7.2 将 为 Python 》 


需要 使 用 如 下 命令 把 MatrixWinUi.ui 文 件 转换 为 MatrixWinUi.py 文 
件 。 如 果 命 令 执行 成 功 ， 在 MatrixWinUi.ui 的 同 级 目录 下 就 会 生成 一 个 
同名 的 .py 文件 。 

pyuic5-o MatrixWinUi.py MatrixWinUi1.ui 

为 了 节省 篇 幅 ， 请 读者 自行 查看 
PyQt5/Chapter03/testCase/MatrixWinUi.py 文 件 。 

为 了 实现 调用 代码 与 界面 的 分 离 ， 需 要 新 建 一 个 文件 
CallMatrixWinUi.py， 直 接 继承 界面 类 和 主 窗口 类 。 使 用 Qt ”Designer 生 
成 窗口 文件 MatrixWinUi.ui 后 ， 还 需要 使 用 pyuic5 命 令 将 它 转换 成 .py 文 
件 ， 然 后 在 调用 主 窗口 的 类 中 重新 加 载 它 就 可 以 了 。 
CallMatrixWinUi.py 文 件 保 存在 PyQt5/Chapter03/mainWin 目 录 下 ， 其 完 
整 代码 如 下 : 








import sys 
from PyQt5.0tWidgets import * 


from MatrixWinUi import * 


class CallMatrixWinUi (QWidget ): 
def init (self, parent=None) : 
super (CallMatrixWinUi, self). init (parent) 
self.ui = Ui MatrixWin() 
self.ui.setupUi (self) 
self.inituvi() 


# 初始 化 窗口 

def initUi(self): 
scrollVal = self.ui.tequilaScrollBar.value () 
self.ui.selScrollBarLbl.setText( str(scrollVal) ) 


sliderVal = self.ui.iceHorizontalSlider.value() 


self.ui.selIceSliderLbl.setText( str(sliderVal) ) 


# 获得 一 个 量 酒 器 的 重量 ， 单 位 : 克 
def getJiggers (self): 
# 返回 玛 格 丽 特 鸡 尾 酒 的 总 容量 ， 以 jigger 量 酒 器 为 单位 
# 一 个 量 酒 器 可 以 容纳 0.0444 HHH 
jiggersTequila = self.ui.tequilaScrollBar.value() 
jiggersTripleSec = self.ui.tripleSecSpinBox.value () 
float (self.ui.limeJuiceLineEdit.text ()) 


jiggersLimeJuice 
jiggersIce = self.ui.iceHorizontalSlider.value() 
return jiggersTequila + jiggersTripleSec + jiggersLimeJuice + 


jiggersiIce 


# 获得 一 个 量 酒 器 的 体积 ， 单 位 : H 
def getLiters (self): 
'! 返回 鸡尾酒 的 总 容量 ( 升 ) ''' 
return 0.0444 * self.getJiggers () 


# 获得 搅拌 速度 
def getSpeedName (self) : 
speedButton = self.ui.speedButtonGroup.checkedButton () 
if speedButton is None: 
return None 


return speedButton.text () 


# 单 击 “OK” 接 钮 后 ， 把 响应 的 结果 显示 在 resultText 文本 框 里 
def uiAccept (self): 
print ('* CallMatrixWinUi accept ') 
print ('The volume of drinks is {0} liters ({1} 
jiggers).'.format (self.getLiters() , self.getJiggers() )) 
print ('The blender is running at speed 
"{O}"'. format (self.getSpeedName() )) 
msgl = ! 饮 料 量 为 : {0} FF ({1} 个 量 酒 器 )。 
'. format (self.getLiters() , self.getJiggers() ) 
msg2 = ' 调 酒 器 的 搅拌 速度 是 : "(0}". '. format (self.getSpeedName() ) 
self.ui.resultText.clear() 
self.ui.resultText.append(msgl1) 
self.ui.resultText.append(msg2) 


# ŽE “cancel” #41, XAA o 
def uiReject (self): 


print('* CallMatrixWinUi reject ') 





运行 脚本 ， 显 示 效 果 如 图 9-52 所 示 。 


操作 结果 


KARA: 1.4652 # (33.0 个 
eee A 酒 器 ) 。 
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图 9-52 


9.7.3 单元 测试 程 





接 下 来 要 对 窗口 类 CallMatrixWinUi 编 写 单元 测试 程序 。 针 对 这 个 窗 
口 编 写 单 元 测试 类 MatrixWinTest.py。 本 例文 件 名 为 
PyQt5/Chapter03/testCase/CallMatrixWinUi.py， 由 于 代码 比较 多 ， 下 面 
一 步 步 进 行 介绍 
1. 编 写 单元 测试 类 
编写 单元 测试 类 MatrixWinTest 使 用 的 是 标准 Python 中 的 unittest 
模块 ， 它 是 Python 内 部 自 带 的 一 个 单元 测试 模块 。 
(1) 首先 导入 unittest 模 块 。 
import unittest 
(2) 定义 一 个 继承 自 unittest.TestCase 的 测试 用 例 类 
MatrixWintTest. 


(3) 定义 setUpO 和 tearDown0O， 在 每 个 测试 用 例 的 前 后 做 一 些 辅助 
工作 。 使 用 setUp() 方 法 调用 测试 类 之 前 的 初始 化 工作 ; 使 用 tearDown() 
方法 调用 测试 类 之 后 的 清理 工作 。 

(4) 定义 测试 用 例 ， 名 字 以 test 开头 ， 比 如 test_moveScrollBar() 
Alltest_tripleSecSpinBox() . 

(5) 一 个 测试 用 例 应 该 只 测试 一 个 方面 ， 测 试 目的 和 测试 内 容 很 
明确 ， 主 要 是 调用 assertEqual、assertRaises 等 断言 方法 判断 程序 执行 结 
末 和 预期 值 是 否 相 符 。 如 果 测 试 未 通过 ， 则 会 输出 相应 的 错误 提示 。 

(6) 调用 unittestmain0 有 启动 测试 。 

常用 的 断言 方法 如 表 9-8 所 示 。 





assertEqual(a, b) 
assertNotEqual(a,b ) 


assertFalse(x ) ll] bool(y) is False 
assertIsNot(a, b) 检测 ais not b 


所 编写 的 单元 测试 类 MatrixWinTest 需 要 继承 自 unittest.TestCase 类 ， 
通过 unittest 模 块 编写 测试 业务 ， 其 完整 代码 如 下 : 
class MatrixWinTest(unittest.TestCase): 
# 初始 化 工作 
def setUp(self): 
print('*** set Up ***') 














self.app=QApplication(sys.argv) 
self.form=CallMatrix WinUi.CallMatrixWinUi() 
self.form.show() 

# 退出 清理 工作 

def tearDown(self): 


print('**** tearDown ***") 
self.app.exec_() 
2. 定 时 关闭 窗口 
运行 完 PyQt 的 测试 用 例 后 ， 所 生成 的 测试 用 例 窗口 是 不 会 主动 消 
失 的 ， 因 为 PyQt 使 用 的 是 事件 主 循环 机 制 ， 当 应 用 局 动 后 ， 主 循环 接收 
事件 消息 并 将 其 分 发 给 程序 的 各 个 控件 。 如 采 调 用 ”exit0 或 主 控件 被 销 
毁 ， 主 循环 就 会 结束 。 使 用 sys.exit(0) 方 法 退出 可 以 确保 程序 完整 地 结 
束 。 所 以 如 果 用 户 不 主动 关闭 窗口 ， 窗 口 是 不 会 消失 的 。 为 了 方便 测 
试 ， 可 以 编写 一 个 线程 类 ， 定 时 关闭 所 生成 的 测试 用 例 窗口 。 
编写 一 个 线程 类 BackWorkThread， 它 继承 自 PyQt 的 QThread 类 ， 秆 
时 从 后 台 关 闭 所 生成 的 测试 用 例 窗口 。 
# 继承 自 QThread 类 
class BackWorkThread(QThread): 
# 声明 一 个 信号 ， 同 时 返回 一 个 str 
finishSignal=pyqtSignal(str) 
# 在 构造 函数 中 增加 形 参 


def _init (self,sleepTime,parent=None): 

















super(BackWorkThread,self).___init__ (parent) 
# 存储 参数 
self.sleepTime=sleepTime 
# 重 写 mun() 隙 数 ， 在 里 面 定 时 执行 业务 
def run(self): 
# 休眠 一 段 时 间 
time.sleep(self.sleepTime) 
# 休眠 结束 ， 发 送 一 个 信号 告诉 主线 程 衫 口 
self.finishSignal.emit(‘ok ,begin to close Window’) 
现在 对 单元 测试 类 MatrixWinTest 进 行 优化 ， 在 单元 测试 类 的 初始 化 


函数 setUpO0 中 ， 新 建 BackWorkThread 线 程 对 象 传 入 时 间 参 数 ， 每 5 秒 就 
关闭 一 个 测试 用 例 。 优 化 后 的 单元 测试 类 MatrixWinTest 的 代码 如 下 : 


class MatrixWinTest (unittest.TestCase): 
# 初始 化 工作 
def setUp (self): 
prine (ee Setup <> =") 
self.app = QApplication(sys.argv) 
self.form = CallMatrixWinUi.CallMatrixWinUi () 


self.form.show() 


# 新 建 线程 对 象 ， 传 入 参数 ， 每 5 秒 关闭 一 个 测试 用 例 
self.bkThread = BackWorkThread(int( 5 ) ) 

# 连接 子 进 程 的 信号 和 槽 函数 
self.bkThread.finishSignal.connect (self.closeWindow) 


#self.bkThread.finishSignal.connect (self.app.exec_ ) 


# 启动 线程 ， 开 始 执行 run () 函数 中 的 内 容 
self. bkThread.start () 


# 退出 清理 工作 
def tearDown(self): 
PELNE (CAs seearbown ~ xai) 


self.app.exec_() 


3. 测 试 调 酒 器 窗口 的 默认 值 

测试 设置 “原料 ”部 分 每 一 个 控件 的 默认 值 ， 以 及 “9 种 搅拌 速度 ”部 
分 的 单 选 钮 CQRadioButton) ， 当 全 部 控件 默认 设置 完毕 后 单 击 “OK” 按 
钮 ， 把 结果 显示 在 “操作 结果 ”部 分 。 





# 测试 用 例 一 一 在 默认 状态 下 测试 GUI 
der test detal ts (selt: 
"测试 GUI 处 于 默认 状态 '' 1' 


Print( *** testCase test defaults begin 747) 


self. 


self. 
self. 
self. 
self: 
self. 


form. setWindowTitle (' 开 始 测试 用 例 test_defaults ') 


assertEqual (self.form.ui.tequilaScrollBar.value(), 8) 
assertEqual (self.form.ui.tripleSecSpinBox.value(), 4) 
assertEqual (self.form.ui.limeJuiceLineEdit.text(),"12.0") 
assertEqual (self.form.ui.iceHorizontalSlider.value(),12) 


assertEqual (self.form.ui.speedButtonGroup. 


checkedButton().text(),"&Karate Chop") 


TEN 


’ 


print ('*** speedName='+ self.form.getSpeedName() ) 


+ 用 鼠标 左 键 单 击 “OK” 按 钮 
okWidget = self.form.ui.okBtn 
QTest.mouseClick(okWidget, QOt.LeftButton) 


# 测 试 窗口 在 默认 状态 下 ， 各 控件 的 默认 值 是 否 与 预期 值 一 样 


self. 
self. 


assertEqual (self.form.getJiggers() , 36.0) 
assertEqual (self.form.getSpeedName(), "&Karate Chop") 


prink("*** testCase test defaults end ***") 


叫 试 例 子 中 ，QTestmouseClick0 用 于 实际 单 击 “OK” 按 钮 。 
运行 测试 用 例 ， 显 示 的 窗口 如 图 9-53 所 示 。 
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4. 测 试 PyQt 的 QScrollBar 

在 运行 测试 用 例 前 ， 将 窗口 中 原料 对 应 的 所 有 控件 中 的 所 有 成 分 数 
值 设 置 为 0， 将 竺 测试 控件 的 成 分 设置 为 非 零 值 〈12 或 -1) 。 比 如 将 龙 
舌 兰 酒 对 应 的 滑动 条 控件 的 值 超过 它 的 合法 范围 ， 设 置 为 12， 而 在 UI 文 
件 中 实际 它 的 最 大 值 为 11、 最 小 值 为 0， 碍 看 窗口 是 否 能 正常 运行 ， 如 
图 9-54 所 示 。 














i t = # 
tequilaScrollBar : QScrollBar | 
属性 值 S 

QAbstractSlider 

singleStep 1 

pageStep 10 

value 8 

sliderPosition 8 

tracking vi 

orientation Horizontal 

@ Karate Chop (©) Beat invertedAppe... g 
invertedContr... LV v 
D Liquefy J Vaporize 信号 / 槽 编辑 器 ar 
+ 
m 发 送 者 信号 接收 者 

tequil-ollBar aC: -d(int) Matrixin uiScronged() 

okBtn clicked NatrixWin uidccept 
iceHor…Slider valueC--d(int) MatrixWin uilceSnged() 
learBtn Clicked) MatrixWin uiClear () 
cancelBtn clicked Matrixin uiReject() 





图 9-54 





为 方便 起 见 ，setFormToZero() 将 所 有 控件 的 值 都 设置 为 0。 
# 设置 窗口 中 所 有 控件 的 值 为 0， 状 态 设 置 为 初始 状态 。 
def setFormToZero(self): 





print('* setFormToZero *') 
self.form.ui.tequilaScrollBar.setValue(0) 
self.form.ui.tripleSecSpinBox.setValue(0) 
self.form.ui.limeJuiceLineEdit.setText("0.0") 
self.form.ui.iceHorizontalSlider.set Value(0) 
self.form.ui.selScrollBarLbl.setText("0") 
self.form.ui.sellceSliderLbl.setText("0") 
P FR WU ASE ALY AR HE POR RTE Vid att EBA 2 2D Te 
A. Wika e/a, A ii, WEIR 
能 否 正 常 使 用 。 





# 测试 用 例 一 一 测试 滑动 条 

def test _moveScrollBar (self): 
ARAH] test_moveScrollBar''' 
Prine *** -cestCase test movesoroliber begin Zarr) 
self.form.setWindowTitle(' 开 始 测试 用 例 test_moveScrollBar ') 


self.setFormToZero () 


# 测试 将 龙 舌 兰 酒 的 滑动 条 的 值 设置 为 12， 在 UI 中 实际 它 的 最 大 值 为 11 
self.form.ui.tequilaScrollBar.setValue( 12 ) 
Prane X 44 self.form.ui.tequilaScrollBar.setValue (12) K, 
ui.tequilaScrollBar.value() => ' + 
str( self.form.ui.tequilaScrollBar.value() ) ) 
self.assertEqual (self.form.ui.tequilaScrollBar.value(), 11 ) 


# 测试 将 龙 知 兰 酒 的 滑动 条 的 值 设置 为 -1， 在 UI 中 实际 它 的 最 小 值 为 0 
self.form.ui.tequilaScrollBar.setValue (-1) 
print('* 44ikfF self.form.ui.tequilaScrollBar.setValue(-1) Æ, 
ui.tequilaScrollBar.value() => ' + 
str( self.form.ui.tequilaScrollBar.value() ) ) 
self.assertEqual (self.form.ui.tequilaScrollBar.value(), 0) 


# 重新 将 将 龙 舌 兰 酒 的 滑动 条 的 值 设 定 置 5 


self.form.ui.tequilaScrollBar.setValue (5) 


# 用 鼠标 左 键 单 击 “OK” 按 锂 

okWidget = self.form.ui.okBtn 
QTest.mouseClick(okWidget, Ot.LeftButton) 
self.assertEqual (self.form.getJiggers() , 5) 
print *** scescCase test moveserollbar end 47") 


运行 测试 用 例 ， 显 示 的 窗口 如 图 9-55 所 示 。 
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图 9-55 


5. 测 试 PyQt 的 QSpinBox 
将 三 重 蒸馏 酒 对 应 的 计数 器 控件 (QSpinBox)〉 的 数值 设置 为 非 零 
fH (12BK-1) , eee ee aes, 最 小 值 为 0， 通 
和 然后 尝试 设置 合法 值 ， 最 后 验 
证 结果 ， 如 图 9-56 所 示 。 
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图 9-56 


# 测试 用 例 一 一 测试 计数 器 控件 (QSpinBox) 
def test_tripleSecSpinBox (self): 


ARAH] test_tripleSecSpinBox ''' 





Ett 值 S 

correctionMo... CorrectToPreviousValue 

keyboardTrac... |v] 

showGroupSe... [| 
> suffix 
> prefix 

singleStep 1 

value 4 

displaylnteger... 10 
ABS / BES ax 
中 一 

信号 接收 者 a 

tequil…ollBar valuec…d(int) MatrixWin uiScro…ngedO 

tn clicke Matrix¥in uidcceptO 
iceHor…Slider valueC-d(int) MatrixWin uilceSnged() 
clearBtn clickedQ Matrix¥in uiClear () 
cancelBtn clickedO MatrixWin uiRejectO 


























mres | Bees 





Dich 2 testcase (Leste mupLeoccop inBox Degi m Eaa) 
self.form.setwindowTitle(' 开 始 测试 用 例 test _tripleSecSpinBox ') 


! 7 测试 修改 计数 器 控件 (QOSpinBox) 的 最 大 值 、 最 小 值 


测试 它 的 最 小 值 和 最 大 值 作为 读者 的 练习 


self.setFormToZero() 

# tripleSecSpinBox 在 界面 中 的 取 值 范围 为 0~11， 将 它 的 最 大 值 设 置 为 12， 看 是 
否 显示 正常 

self.form.ui.tripleSecSpinBox.setValue (12) 

print('* 当 执 行 self.form.ui.tripleSecSpinBox.setValue(12) Æ, 
ui.tripleSecSpinBox.value() => ' + 
str( self.form.ui.tripleSecSpinBox.value() ) ) 

self.assertEqual (self.form.ui.tripleSecSpinBox.value(), 11 ) 


# tripleSecSpinBox 在 界面 中 的 取 值 范围 为 0~11， 将 它 的 最 小 值 设置 为 -1， 看 是 
否 显示 正常 

self.form.ui.tripleSecSpinBox.setValue (-1) 

print('* 当 执 行 self.form.ui.tripleSecSpinBox.setValue (-1) Æ, 
ui.tripleSecSpinBox.value() => ' + 
str( self.form.ui.tripleSecSpinBox.value() ) ) 

self.assertEqual (self.form.ui.tripleSecSpinBox.value(), 0 ) 


self.form.ui.tripleSecSpinBox.setValue (2) 


# 用 鼠标 左 键 单 击 “OK” 按 钮 

okWidget = self.form.ui.okBtn 
QTest.mouseClick(okWidget, QOt.LeftButton) 
self.assertEqual (self.form.getJiggers(), 2) 
print('*** testCase test triplesecSpinBbox end ***") 


运行 测试 用 例 ， 显 示 的 窗口 如 图 9-57 所 示 。 
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图 9-57 


6. 测 试 PyQt 的 QLineEdit 

使 用 QTest.keyClicks0 实 际 输入 一 个 字符 串 到 limeJuiceLineEdit 文 本 
框 控 件 中 ， 在 本 例 中 是 将 字符 串 "3.5" 输 入 到 limeJuiceLineEdit 文本 框 控 
件 中 。 这 里 使 用 QTest.keyClicks()， 是 因为 本 文 强调 QtTest。 如 果 使 用 
QLineEdit.setTextO 直 接 设置 控件 文本 ， 测 试 结果 也 是 一 样 的 。 





# 测试 用 例 一 一 测试 柠 榜 汁 单行 文本 框 
def test limeJuicebinerdit(selt): 
'' MIKA] test _limeJuiceLineEdit ''' 


print ('*** testCase test limeJuicebinekdit begin ***") 
self.form.setWindowTitle(' 开 始 测试 用 例 test_limeJuiceLineEdit ') 


' 1 测试 修改 lineEdit 文本 框 控件 的 最 大 值 、 最 小 值 
测试 它 的 最 小 值 和 最 大 值 作 为 读者 的 练习 


self.setFormToZero () 

# 清除 lineEdit 文本 框 控件 值 ， 然 后 在 lineEdit 文本 框 控件 中 输入 "3 .5" 
self.form.ui.limeJuiceLineEdit.clear () 

QTest.keyClicks (self.form.ui.limeJuiceLineEdit, "3.5") 


# 用 饼 标 左 键 单 击 “OK” 按 钮 

okWidget = self.form.ui.okBtn 
QTest.mouseClick(okWidget, Qt.LeftButton) 
self.assertEqual (self.form.getJiggers() , 3.5) 
printi neo testede Lest, Ln Le in end arn) 


运行 测试 用 例 ， 显 示 的 窗口 如 图 9-58 所 示 。 
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图 9-58 


7. 测 试 PyQt 的 QSlider 
测试 冰 块 滑动 条 控件 ， 其 核心 代码 如 下 : 
# 测试 用 例 一 一 测试 iceHorizontalSlider 
def test_iceHorizontalSlider(self): 
"测试 用 例 test_iceHorizontalSlider " 
print('*** testCase test_iceHorizontalSlider begin ***') 
self.form.setWindowTitle(' 开 始 测试 用 例 test_iceHorizontalSlider 


"测试 冰 块 滑动 条 控件 
测试 它 的 最 小 值 和 最 大 值 作为 读者 的 练习 


LALI 





self.setFormToZero() 


self.form.ui.iceHorizontalSlider.set Value(4) 

# 用 鼠标 左 键 单 击 ^“OK” 按 钮 

okWidget=self.form.ui.okBtn 

QTest.mouseClick(okWidget,Qt.LeftButton) 

self.assertEqual(self.form.getJiggers(),4) 

print('*** testCase test_iceHorizontalSlider end ***') 
运行 测试 用 例 ， 显 示 的 窗口 如 图 9-59 所 示 。 
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图 9-59 


8. 测 试 PyQt 的 QRadioButton 

在 “9 种 搅拌 速度 ”部 分 包含 了 9 个 单 选 按钮 ， 测 试 选中 每 个 单 选 按 
钮 ， 取 得 的 值 是 否 和 单 选 按钮 的 文本 一 致 。 比 如 搅拌 速度 的 文本 显示 的 
是 '&Mix， 则 意味 着 按 住 *Alt 键 +M” 快 捷 键 ， 可 以 快速 定位 到 “Mix” 单 选 





按钮 。 


运 


# 测试 用 例 一 一 测试 搅拌 速度 单 选 按钮 

def test_blenderSpeedButtons(self): 

print('*** testCase test_blenderSpeedButtons begin ***') 
self.form.ui.speedButton1.click() 
self.assertEqual(self.form.getSpeedName(),"&Mix") 
self.form.ui.speedButton2.click() 
self.assertEqual(self.form.getSpeedName(),"& Whip") 
self.form.ui.speedButton3.click() 
self.assertEqual(self.form.getSpeedName(),"&Puree") 
self.form.ui.speedButton4.click() 
self.assertEqual(self.form.getSpeedName(),"&Chop") 
self.form.ui.speedButton5.click() 
self.assertEqual(self.form.getSpeedName(),"&Karate Chop") 
self.form.ui.speedButton6.click() 
self.assertEqual(self.form.getSpeedName(),"&Beat") 
self.form.ui.speedButton7.click() 
self.assertEqual(self.form.getSpeedName(),"&Smash") 
self.form.ui.speedButton8.click() 
self.assertEqual(self.form.getSpeedName(),"&Liquefy") 
self.form.ui.speedButton9.click() 
self.assertEqual(self.form.getSpeedName(),"&Vaporize") 
print('*** testCase test_blenderSpeedButtons end ***') 
行 测试 用 例 ， 显 示 的 窗口 如 图 9-60 所 示 。 
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图 9-60 
9.7.4 运行 测试 用 例 


这 一 节 讲 解 运 行 单元 测试 类 MatrixWinTest。 运 行 单元 测试 类 有 两 种 
方法 : 一 种 是 默认 执行 所 有 的 测试 用 例 ， 另 一 种 是 按照 指定 顺序 执行 测 
试用 例 。 

首先 需要 导入 unittest 模 块 。 

import unittest 
1. 默 认 执 行 所 有 的 测试 用 例 
默认 执行 所 有 的 测试 用 例 ， 其 核心 代码 如 下 : 
if_ name ==" main ": 
unittest.main() 


使 用 以 下 命令 ， 将 测试 结果 报告 保存 到 reportLog.txt 日 志文 件 中 。 


python MatrixWinTest.py > > ./reportLog.txt 2 > &1 
2. 按 照 指 定 顺 友 执 行 测 试用 例 
为 了 更 加 灵活 地 执行 测试 用 例 ， 可 以 按照 指定 顺序 进行 。 其 核心 代 
码 如 下 : 
if name ==" main _": 
suite=unittest.TestSuite() 
suite.addTest(MatrixWinTest("test_defaults")) 
suite.addTest(MatrixWinTest("test_moveScrollBar")) 
suite.addTest(MatrixWinTest("test_tripleSecSpinBox")) 
suite.addTest(MatrixWinTest("test_limeJuiceLineEdit")) 
suite.addTest(MatrixWinTest("test_iceHorizontalSlider")) 
suite.addTest(MatrixWinTest("test_liters")) 
suite.addTest(MatrixWinTest("test_blenderSpeedButtons")) 
runner=unittest.TextTestRunner() 


runner.run(suite) 
9.7.5 生成 测试 报告 


虽然 可 以 通过 unittest 生 成 测试 日 志 ， 但 是 把 测试 结果 汇总 到 测试 报 
告 里 ， 需 要 手工 完成 ， 这 样 色 浪费 了 人 力 ， 有 没有 更 简单 的 方法 呢 ? 

有 的 ， 可 以 使 用 HTMLTestRunner 生 成 测试 报告 。 

HTMLTestRunner 是 Python 标准 库 unittest 模 块 的 一 个 扩展 库 ， 使 用 
它 可 以 生成 易于 使 用 的 HTML 测 试 报告 。 





(1) 下 载 HTMLTestRunner.py 文件 ， 地 址 是 : 
http://tungwaiyip.info/software/HTMLTestRunner.html， 如 图 9-61 所 示 。 
HTMLTestRunner 现 在 只 支持 Python 2 环境 ， 需 要 将 


HTMLTestRunner 修 改 成 支持 Python 3 版 本 ， 笔 者 参考 了 热心 网 友 的 博 


pa http://www.cnblogs.com/sgtb/p/4169732.html, 1% r% 
HTMLTestRunner.py 的 源码 让 它 文 持 Python 3 环境 。 


home HTMLTestRunner 


links HTMLTestRunner is an extension to the Python standard library's unittest 
module. It generates easy to use HTML test reports. See a sample report 
here. HTMLTestRunner is released under a BSD style license. 


14 comments 





Download 


HTMLTestRunner.py (0.8.2) 








test HTMLTestRunner. py test and demo of HTMLTestRunner.py 


Return to my software. 
图 9-61 


支持 Python 3 环境 的 HTMLTestRunner.py 文 件 位 于 
PyQt5/Chapter03/testCase 目 录 下 ， 请 读者 自行 下 载 。 
(2) 配置 测试 环境 。 把 HTMLTestRunner.py 文 件 放 在 Python3/lib 目 
录 下 ， 在 笔者 的 机 器 上 是 Ei:\installed_software\python35\Lib 目 录 。 
(3) 生成 测试 报告 
本 例文 件 名 为 PyQt5/Chapter03/testCase/RunTestCase.py， 演 示 测 试 
用 例 代码 HTMLTestRunner 整 合 测 试 报告 。 其 完整 代码 如 下 : 


import unittest 
import HTMLTestRunner 
import time 


from MatrixWinTest import MatrixWinTest 
Grete EG rr es eT LULA a 


now = time.strftime("%Y-%m-%d-%H SM %S", 
time.localtime (time.time())) 

print( now ) 

testunit = unittest.TestSuite() 


testunit.addTest (unittest.makeSuite (MatrixWinTest )) 


htmlFile = ".\\"+now+"HTMLtemplate.html" 
print( 'htmlFile='+ htmlFile) 
fp = open(htmlFile, 'wb') 
runner = HTMLTestRunner.HTMLTestRunner ( 
stream=fp, 
title=u"PyOt5 测试 报告 "， 
description=u" 用 例 测试 情况 ") 
runner.run(testunit) 


fp.close() 





运行 脚本 后 ， 会 生成 测试 报告 ， 测 试 报告 的 格式 为 : {当前 日 期 - 当 
前 时 间 }HTMLtemplate.html， 例 如 2017-05-26- 
20_22_06HTMLtemplate.html， 显 示 效 果 如 网 9-62 所 示 。 相 信 有 经 验 的 程 
序 员 看 到 测试 结果 为 pass， 都 会 会 心 一 笑 ， 终 于 有 数据 可 以 证 明 自 己 编 
写 的 代码 没有 问题 了 。 








PyQt5 测 试 报告 


Start Time: 2017-05-28 16:27:51 
Duration: 0:00:35.213974 
Status: Pass 7 


























Count Pass Fail Error 
test_blenderSpeedButtons | pass 
test_defaults: 测试 GUI 处 于 默认 状态 | pass 
test_iceHorizontalSlider: 测试 用 例 test_iceHorizontalSlider | pass 
test_limeJuiceLineEdit: 测试 用 例 test_limeJuiceLineEdit | pass 
test_liters: 测试 用 例 test_liters | pass 
test_moveScrollBar: 测试 用 例 test_moveScrollBar | pass 
test_tripleSecSpinBox: 测试 用 例 test_tripleSecSpinBox | Dass 
ies Sie ee 7 7 0 lo | 




















图 9-62 





10.1 获取 城市 天 气 预 


使 用 Python 获 取 天 气 预报 很 简单 ， 就 是 发 送 一 个 HTTP 请 求 ， 然 后 
解析 请 求 返 回 的 结果 ， 最 后 把 请 求 结 末 显示 在 窗口 中 。 





10.1.1 获 AX 


AEH Python Aaa APPT, A eR 
方式 ， 获 取 天 气 预 报 网 站 的 HTML 页面， 然后 使 用 XPath 或 BeautifulSoap 
解析 HIML 页 面 的 内 容 ， 另 一 种 方法 是 通过 天 气 预报 网 站 提供 的 API, 
直接 获取 结构 化 数据 ， 省 去 了 解析 HTML 页 面 这 一 步 。 本 例 使 用 中 国 天 
气 网 站 提供 的 API。 中 国 天 气 官 网 地 址 是 : http://www.weather.com.cn/, 
如 图 10-1 所 示 。 

获取 天 气 数据 使 用 的 是 Requests 库 ， 它 是 使 用 Python 语言 基于 
urllib 编写 的 HITP 库 ， 需 要 使 用 pip 命 令 进行 安装 。 

pip install requests 

Requests 库 包含 一 个 名 为 json 的 方法 ， 当 请 求 的 地 址 返回 的 是 JSON 

格式 的 数据 时 ， 直 接 使 用 该 方法 访问 即 可 ， 而 不 需要 再 使 用 Python 标准 














库 中 的 json 库 。 


HAKA Q 北京 SH 11/290 + 
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图 10-1 





请 求 地 址 是 : http://www.weather.com.cn/data/sk/ 城 市 代码 .html。 
部 分 城市 代码 如 表 10-1 所 示 ， 完 整 的 城市 代码 可 以 在 网 上 搜索 到 。 


101010100 


101030100 





a 


4210-2 


weatherInfo 消息 根 节点 
sa 





time 
mn te? PRS, 1, ABN; 0 EN 
是 否 有 雷达 图 ，1， 代 表 有 雷达 图 ; 0， 代 表 没 有 雷达 图 





例如 ， 在 浏 TA 
http://www.weather.com.cn/data/sk/101010100.html 这 个 请 求 地 址 ， 浏 览 
就 会 返回 北京 的 天 气 实况 信息 ， 该 信息 其 实 就 是 一 个 JSON 格 式 的 字符 
串 ， 格 式 化 后 字符 串 像 下 面 这 样 : 


"weatherinfo": { 


orones AA “Aba, 

i J Yat TIOILOLOTOOY, 

Trempe TEET 

"WD": "东南 风 "， 

"ws" a 

Hops A, 

MUSE TUF, 

Memes TAROS 

TisSRadart: Is, 

"Radar": "JC RADAR AZ9010 JB", 


sag bo ae " 暂 无 实况 "， 
Marys "1011", 


LT er Ba Ln able UY) 
} 


本 例文 件 名 为 PyQt5/Chapter10/examplel/getWeatherInfo.py， 代 码 如 
PF: 
import requests 
rep=requests. get(‘http://www.weather.com.cn/data/sk/101010100.ht 
rep.encoding="utf-8' 
print(' 返 回 结果 : %s' % rep.json() ) print( 城 市 : %s' % 
rep.json()['weatherinfo']['city']) 
print(')*\ [=]: %s' % rep.json()['weatherinfo']["WD']) 
print(' 温 度 : %s' % rep.json()['weatherinfo']['temp']+ " FZ") 
print(' 风 力 : %s' % rep.json()['weatherinfo']['WS']) 
print(' 湿 度 : %s' % rep.jsonO["weatherinfo']['SD']) 
以 上 代码 加 载 指 定 网 页 ， 模 拟 发 送 一 次 HTTP 的 GET 请 求 ， 请 求 成 
功 后 会 得 到 一 个 响应 值 (Response Text) ， 这 个 响应 值 就 是 中 国 天 气 网 
返回 的 天 气 数据 ， 而 且 是 JSON 格 式 的 字符 串 。 











注意 

中 国 天 气 网 返回 的 天 气 数据 是 utf-8 格 式 的 ， 为 了 避免 出 现 乱 码 ， 对 
于 所 返回 的 数据 也 一 定 要 使 用 utf-8 格 式 解码 。 

运行 脚本 ， 显 示 结 果 如 下 ， 表 示人 查询 天 气 的 业务 逻辑 代码 调试 成 
功 。 














返回 结果 : {'weatherinfo': {'city’: 北京 ,cityid': 
'101010100','temp':'18',"WD': “东南 风 ,"WS': "1 级"SD': '17%','WSE': 
Ttime': '17:05','isRadar': '1',"Radar': JC_RADAR_AZ9010_JB','njd': ' 暂 
无 实况 ,"qy': '1011','rain': '0'}} 

城市 : 北京 

PALA]: 东南 风 

温度 : 18 È 

风力 : 1 级 

湿度 : 17% 





10.1.3 界面 实现 


使 用 Qt _ Designer 来 设计 天 气 预 报 窗口 ， 如 图 10-2 和 图 10-3 所 示 。 本 
例文 件 名 为 PyQt5/Chapter10/example1/WeatherWin.ui。 
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图 10-3 





从 图 10-3 中 可 以 看 出 ， 在 界面 文件 WeatherWin.ui 中 定义 了 两 个 按 
钮 ， 查 询 按钮 的 对 象 名 称 为 okBtn， 清 空 按钮 的 对 象 名 称 为 queryBtn， 
并 把 查询 按钮 的 “clicked 信 和 号 与 queryWeather0O 酸 函数 进行 绑 定 ， 清 空 按 
钮 的 clicked 信 号 与 clearResult(O 模 函数 进行 绑 定 。 

在 “城市 ?下 拉 列 表 框 中 默认 显示 的 是 “北京 ”， 单 击 “ 碍 询 ” 按 钮 ， 把 
查询 结果 显示 在 窗口 中 ; 单 击 “ 清 空 ”按钮 ， 可 以 清除 窗口 中 所 显示 的 天 


气 信息 。 














在 窗口 中 布局 了 多 个 控件 ， 下 面 对 这 些 控件 进行 简要 说 明 ， 如 表 
10-3 上 所 示 。 


表 10-3 


控件 类 型 控件 名 称 作 用 
QComboBox weatherComboBox 显示 城市 下 拉 列 表 框 ， 添 加 了 3 个 条 目 : 北京 、 天 津 和 上 海 。 





oa URR UNAR 


QPushButton queryBtn 查询 天 气 信 息 ， 连 接 queryWeather 函数 进行 绑 定 ， 触 发 clicked 信和 号 
QPushButton clearBtn 清空 查询 结果 ， 连 接 clearResult 函数 进行 绑 定 ， 触 发 clicked 信和 号 


10.1.4 将 为 ， 








使 用 pyuic5 命令 将 界面 文件 转换 为 .py 文件 ， 转 换 后 的 Python 文件 
名 是 WeatherWin.py。 
pyuic5-o WeatherWin.py WeatherWin.ui 
本 例文 件 名 为 PyQt5/Chapter10/example1/WeatherWin.py， 其 完整 代 
码 如 下 : 


from PyQt5 import QtCore, QtGui, QtWidgets 


class Ui_Form (object): 
def setupUi (self, Form): 

Form.setObjectName ("Form") 
Form.resize(450, 347) 
self.groupBox = QtWidgets.QGroupBox (Form) 
self.groupBox.setGeometry (QtCore.QRect (10, 10, 431, 251)) 
self.groupBox.setObjectName ("groupBox") 
self.weatherComboBox = QtWidgets.QComboBox (self.groupBox) 
self.weatherComboBox.setGeometry (OtCore.QRect (80, 30, 221, 21)) 
self.weatherComboBox.setObjectName ("weatherComboBox") 
self.weatherComboBox.addItem("") 
self.weatherComboBox.addItem("") 
self.weatherComboBox.addItem("") 
self.resultText = QtWidgets.QTextEdit (self.groupBox) 
self.resultText.setGeometry (QtCore.QRect(10, 60, 411, 181)) 
self.resultText.setObjectName ("resultText") 
self.label = QtWidgets.QLabel (self.gqroupBox) 
self.label.setGeometry (QtCore.QRect (20, 30, 72, 21)) 
self.label.setObjectName ("label") 
self.okButton = QtWidgets.QPushButton (Form) 
self.okButton.setGeometry (QtCore.QRect (90, 300, 93, 28)) 
self.okButton.setObjectName ("okButton") 
self.clearBtn = QtWidgets.QPushButton (Form) 
self.clearBtn.setGeometry (OQtCore.QRect (230, 300, 93, 28)) 
self.clearBtn.setObjectName ("clearBtn") 


self.retranslateUi (Form) 
self.clearBtn.clicked.connect (Form.clearResult) 
self.okButton.clicked.connect (Form.queryWeather) 
QtCore.QMetaObject.connectSlotsByName (Form) 


def retranslateUi(self, Form): 
_translate = QtCore.QCoreApplication.translate 
Form.setWindowTitle(_ translate("Form", "Form")) 
self.groupBox.setTitle(_translate("Form", "查询 城市 天 气 ")) 
self.weatherComboBox.setItemText(0, _translate("Form", wate) ) 
self.weatherComboBox.setItemText(1, _translate("Form", "天 津 ")) 
self.weatherComboBox.setItemText (2, _translate("Form", "上 海 ")) 
self.label.setText (_translate("Form", "城市 ") ) 
self.okButton.setText (_translate("Form", "查询 ")) 
self.clearBtn.setText(_translate("Form", "清空 ")) 





在 主 窗口 类 MainWindow 中 调用 界面 类 Ui Form， 然 后 在 主 窗口 次 
中 添加 查询 天 气 的 业务 逻辑 代码 ， 这 样 就 做 到 了 界面 显示 和 业务 逻辑 的 
分 离 。 

本 例文 件 名 为 PyQt5/Chapter10/example1/CallWeatherWin.py， 在 主 
窗口 类 中 定义 了 两 个 槽 函数 queryWeather() 和 clearResult()， 以 便 在 界面 
文件 WeatherWin.ui 中 定义 的 两 个 按钮 (gueryBtn 和 clearBtn) 触发 clicked 
信号 与 这 两 个 槽 函数 进行 绑 定 。 其 完整 代码 如 下 : 


def 


if cityName == bF" 
cityCode = '101010100' 


elif cityName == IAF" 
cityCode = '101030100' 
elif cityName == "E" 


cityCode = '101020100' 
return cityCode 
clearResult (self): 


prin = jellearResuiets 1") 
self.ui.resultText.clear () 


if name ==" main ": 


app 
win 


win. 


sys 


运行 脚本 ， 显 示 效 果 如 图 10-4 所 示 。 





QApplication(sys.argv) 
= MainWindow() 


show () 


-exit (app.exec_()) 


查询 城市 天 气 
城市 。 “| 北京 





: 北京 

: 东南 风 
: 18 度 
: 1 级 

: 17% 


图 10-4 


10.2 Wits 


10.2.1 复 利 计算 业务 


复 利 计 算 ， 是 指 每 经 过 一 个 计 居 期 后 ， 都 要 将 本 期 所 生 的 利息 加 入 
本 金 中 ， 以 计算 下 期 的 利息 。 这 样 ， 在 每 一 个 计 息 期 内 ， 上 期 的 利息 都 
将 成 为 生息 的 本 金 ， 即 以 利生 利 ， 也 就 是 俗称 的 “ 利 深 利 ”。 这 就 涉及 了 
复 利 现 值 、 复 利 终 值 和 复 利 计算 公式 。 

复 利 现 值 ， 是 指 在 计算 复 利 的 情况 下 ， 要 达到 未 来 某 一 特定 的 资金 
金额 ， 现 在 必须 投入 的 本 金 。 所 谓 复 利 ， 也 称 利 上 加 利 ， 是 指 一 笔 存 球 
或 者 投资 获得 回报 之 后 ， 再 连 本 带 利 进行 新 一 轮 投 资 的 方法 。 

SRA, FETA TELA EIR ARAL Se, ALA Ae 
ETENE, BREA TEAS HN AN ez. 

复 利 计算 公式 是 : S=P(1 十 DAn。 其 中 ，P 为 本 金 ，i 坟 利率 ，n 为 持 
有 期 限 。 

例如 : 某 人 用 20000 元 人 民 币 投资 一 个 项 目 ， 年 报酬 率 为 59%， 那 么 
两 年 后 利 县 收入 是 多 少 ? 

按照 复 利 计算 公式 进行 计算 ， 所 获 的 利 县 收入 就 是 : 

20000x(1+5%)^2=2000x(1+5%)x(1+5%) 
=2000 x 1.05 x 1.05 
=22050 (70) 














10.2.2 界面 实现 


本 例文 件 名 为 PyQt5/Chapter10/example2/interest.py， 其 完整 代码 如 





self. 
self. 


amountLabel = 
self. 


grid 


grid. 
grid. 
grid. 
grid. 
grid. 
grid. 
grid. 
grid. 
self. 


self 


self. 
self. 


self. 


self 


yearsComboBox.addItem("1 year") 

yearsComboBox.addItems(["{0} years". format (x) 
for x in rangeela 3:1.) ]} 

QLabel ("Amount") 

amountLabel = QLabel () 

= QGridLayout () 

addWidget (principalLabel, 0, 0) 

addWidget (self.principalSpinBox, 0, 

addWidget (rateLabel, 1, 0) 

addWidget (self.rateSpinBox, 

addWidget (yearsLabel, 2, 0) 

addWidget (self. yearsComboBox, 

addWidget (amountLabel, 3, 0) 


addWidget (self.amountLabel, 


1) 
ibe 1) 


Zr 13) 





SP 1 


setLayout (grid) 


-principalSpinBox.valueChanged.connect (self.updateUi) 


rateSpinBox.valueChanged.connect (self.updateUi) 


yearsComboBox. current IndexChanged. connect (self.updateUi) 


setWindowTitle ("Interest") 


.upaateUi () 


def updateUi(self): 


principal = self.principalSpinBox.value() 

rate = self.rateSpinBox.value() 

years = self.yearsComboBox.currentIndex() + 1 
amount = principal * ((1 + (rate / 100.0)) ** years) 


self.amountLabel.setText ("RMB {0:.2f}".format (amount) ) 


i£ name ==" main ">: 
app = 
form = 


QApplication(sys.argv) 
Form () 
form. show () 


sys.exit (app.exec_()) 


运行 脚本 ， 显 示 效 果 如 图 10-5 所 示 。 某 人 使 用 20000 元 人 民 币 投资 


一 个 项 目 ， 年 报酬 率 为 5%， 预 计 获得 的 收入 为 22050 元 ， 与 本 市 开始 介 
绍 的 复 利 计算 所 获得 的 收益 是 一 样 的 。 





Principal: RMB 20000. 00 
Rate: 5.00 % 





Years: |2 years 
Anount RMB 22050. 00 





图 10-5 


10.3 刷新 博客 点 击 量 








N 
B 


RUN PN A mT SR eT NS, R mE A a S| APT 
代码 ， 就 可 以 统计 页 面 的 浏览 次 数 。 赠 人 玫瑰 ， 手 有 余 香 。 学 习 知 识 也 
是 一 样 的 ， 在 成 束 别 人 的 同时 也 提高 了 自己 。 

网 友 不 藉 子 的 官方 网 站 : http://busuanzi.ibruce.info/， 如 图 10-6 所 





S 
~ 


两 行 代码 搞定 计数 


本 文 总 阅读 量 151974 次 本 站 总 访问 量 176012 次 本 站 总 访客 数 40527 人 


图 10-6 





可 以 看 到 网 友 不 铬 子 的 网 站 提供 的 访问 网 页 计数 的 功能 代码 非常 简 


单 ， 只 需 复制 两 行 代 码 到 目 己 的 网 站 页 面 就 可 以 搞定 。 复 制 的 代码 如 
T: 











< scriptasync src="//dn- 
Ibstatics.qbox.me/busuanzi/2.3/busuanzi.pure.mini.js" > < /Script > 


< span id="busuanzi_container_site_pv" > 


本 站 总 访问 量 < span id="busuanzi_value_site_pv" > < /span > 次 < 


br > 
本 文 总 阅读 量 < span id="busuanzi_value_page_pv" > < /span > 次 
< /Span > 
在 笔者 的 博客 Chttp://www.cnblogs.com/wangshuol/) 后 台 设 置 页 面 
的 侧 边 栏 公告 中 添加 以 上 两 行 代 码 ， 如 图 10-7 所 示 。 
SEMEA SHTML) (支持 1S 代码 ) 
Pn olla a ai 精通 J2EE, JS, HTML5 等 技术 ， 熟 悉 Python, I0S 和 Android. 迷恋 英语 发 音 <br/> 念 念 不 总 , 必 有 回响 , 有 一 口气 , mB). <br/ RR 


Email: xpws2006@163. com<br/> 


微 信 pingws<b 
‘script async src="//dn-lbstatics. qbox. me/busuanzi/2. 3/busuanzi. pure. mini. js”></script 
span id="busuanzi_container_site_pv’ 

本 站 总 访问 量 <span id="busuanzi_value_site_pv”></spanyX <br. 


本 文 总 阅读 量 Cspan id="busuanzi_value_page_pv”></span>7X 
span 





图 10-7 


本 例文 件 名 为 PyQt5/Chapter10/example3/openweb.py， 其 完整 代码 
如 下 : 
from PyQt5.QtWebEngineWidgets import QWebEngineView 
from PyQt5.QtCore import * 
from PyQt5.QtWidgets import * 
class WebView(QWebEngineView): 
def init__(self ): 
super(WebView,self)._ init__() 
url="'http://www.cnblogs.com/wangshuo1/p/6707631.html' 
self.load( QUrl( url ) ) 
self.show() 
# IEH ERT a5) a K A Bel A 
QTimer.singleShot(1000*5 ,self.close) 
运行 以 上 代码 将 弹出 一 个 窗口 ， 使 用 QWebEngineView 类 打开 了 指 


定 的 网 页 ，5 秒 后 使 用 定时 费 QTimer 关 闭 窗口 。 
本 例文 件 名 为 PyQt5/Chapter10/example3/CallOpenWeb.py， 调 用 代 
码 如 下 : 
import time 
import os 
if name ==' main ': 
for i in range(5): 
os.system("python openweb.py") 
Print(" 正 在 刷新 页 面 .次 数 => " ,i) 
time.sleep(10) 
运行 脚本 后 ， 弹 出 一 个 加 载 指定 网 页 的 窗口 ， 如 图 10-8 所 示 ， 窗 口 
显示 5 秒 后 会 自动 消失 。 整 个 过 程 总 共 循 环 5 次 ， 代 表 刷 新 5 次 页 面 。 








PyQt5 api 帮助 文档 


学 习 PyQt5 的 帮助 文档 是 通过 ， 使 用 help(PyQt5 class) 的 方式 
在 console 端 输出 帮助 内 容 ， 常 用 的 方法 和 属性 查找 起 来 不 是 很 方 
©, 现在 放 在 网 上 以 方便 大 家 使 用 . 


QWidget 
Qt 
QMainWindow 


TableWidget 





TableWidgetltem 





OOVRoxi avait 














图 10-8 


在 运行 CallOpenWeb.py 文 件 前 ， 可 以 看 到 
http://www.cnblogs.com/wangshuo1/p/6707631.html 页 面 中 本 文 总 阅读 量 
是 118 次 ， 如 图 10-9 所 示 。 





本 站 总 访问 量 1308 次 
本 文 总 阅读 量 118 次 





图 10-9 


刷新 页 面 后 ， 本 文 总 阅读 量 就 变 成 了 124 次 ， 如 图 10-10 所 示 。 
为 机 器 刷新 页 面 5 次 ， 手 工 刷 新 页 面 1 次 ， 所 以 本 文 总 阅读 量 就 是 : 118 


+5+1=124 次 。 





本 站 总 访问 量 1315 次 
本 文 总 阅读 量 124 次 





图 10-10 





在 前 面 的 章节 中 ， 我 们 介绍 了 PyQt 5 的 基本 用 法 与 扩展 应 用 ， 接 
下 来 将 介绍 PyQt 5 在 实际 中 的 应 用 。 

理论 上 说 ， 使 用 Qt 能 做 的 事情 ，PyQt 也 能 做 ， 但 是 我 们 并 不 会 使 用 
PyQt 去 开发 WPS Office、Photoshop 等 这 样 的 大 型 软件 ， 只 需 利 用 PyQt 相 
对 于 Qt 的 便捷 性 去 快速 开发 一 些小 型 软件 就 可 以 了 。 

本 章 主 要 介绍 PyQt 5 在 金融 领域 的 应 用 。 在 金融 行业 中 ， 人 修得 IT 技 
术 的 人 是 很 吃香 的 ， 因 为 金融 离 不 开 数 据 分 析 与 处 理 ， 数 据 分 析 与 处 理 
离 不 开 编 程 。 那 么 PyQt 5 在 这 里 有 什么 用 呢 ? 想 想 看 ， 老 板 交 给 你 一 个 
任务 ， 你 为 了 好 好 表现 ， 运 用 上 自己 的 编程 能 力 ， 完 美 地 完成 了 这 个 任 
务 。 但 是 这 个 任务 每 周 都 需要 定期 来 做 ， 感 觉 挺 麻 烦 的 ， 于 是 你 想到 了 
PyQt 5 一 一 使 用 它 做 了 一 个 界面 ， 老 板 只 需要 点 击 几 下 鼠标 、 选 择 几 个 
参数 就 可 以 进行 自动 处 理 了 。 老 板 使 用 后 非常 开心 ， 这 样 你 驶 既得 到 了 
老板 的 赏识 ， 又 减轻 了 自己 的 负担 。 接 下 来 在 正式 介绍 使 用 PyQt 5 开发 
GUI 之 前 ， 我 们 先 来 了 解 控 件 级 别 的 布局 管理 和 窗口 级 别 的 布局 管理 。 

















首先 打开 Qt Designer， 新 建 一 个 窗口 ， 并 先后 向 里 面 添加 一 个 
Scroll ”Area、 两 个 Widget 和 一 个 Tab 控 件 ， 然 后 把 其 他 控件 拖 入 Scroll 
Area 中 。 

对 于 其 中 的 一 个 Widget， 设 置 提 升 的 窗口 类 ， 如 图 11-1 所 示 ; 对 
于 男 一 个 QWidget， 设 置 对 象 名 为 “widget_parameter_tree”。 


y 提升 的 窗口 部 件 - Qt Designer x 
提升 的 类 
名 称 头 文件 全 局 包含 用 法 
Y QWidget 


QWebEngineView PyQt5.QtWebEngineWidgets 四 








图 11-1 


对 于 Tab 控 件 ， 设 置 三 个 标签 并 分 别 命名 为 : 月 度 收 益 ， 区 间 收 益 
和 回 撤 情 况 。 然 后 在 这 三 个 标签 中 添加 QWidget， 并 设置 提升 的 窗口 类 
为 QWebEngineView。 

最 后 对 所 有 的 QWebEngineView 类 修改 样式 ， 选 中 它 并 单 击 鼠标 右 
键 ， 从 弹出 的 快捷 菜单 中 选择 “修改 样式 表 ”- “添加 颜色 ”，background- 
color 选 择 灰 色 。 这 样 做 只 是 为 了 更 好 地 区 分 QWidget 和 
QWebEngineView， 如 果 你 觉得 比较 奈 烦 或 者 不 想 这 样 做 ， 也 可 以 忽略 








这 一 步 操 作 。 初 步 效果 如 图 11-2 所 示 。 


O 基金 量化 投 研 系统 v0.11 - fundFOF.ui* 


«ASR 区间 收益 GD) 





图 11-2 


注意 
在 窗口 左边 用 鼠标 选中 的 控件 是 widget_parameter_tree， 其 他 控件 
都 很 容易 识别 出 来 。 
接 下 来 进行 布局 管理 。 
(1) 设置 fabWidget 的 minimumsize 属 性 ， 高 度 与 宽度 都 为 200。 
(2) 选中 tabWidget 的 每 一 个 页 ， 然 后 单 击 鼠标 右键 ， 从 弹出 的 快 
TES ALP Fe Ap Jay” = “水平 布 局 ”〈 也 可 以 选择 “年 直 布局 ”) 。 
(3) 选中 tabWidget 和 上 面 的 QWebEngineView， 然 后 单 击 鼠 标 右 
键 ， 从 弹出 的 快捷 染 单 中 选择 “布局 ” — “垂直 布局 ”。 








这 样 设置 之 后 ， 你 会 发 现 


QWebEngineView 不 见 了 。 设 置 


QWebEngineView 的 minimumsize 属 性 ， 最 小 高 度 为 100， 


QWebEngineView 就 可 以 看 到 了 。 





(4) 选中 上 面 的 垂直 布局 管理 器 和 widget_parameter_ tree， 然 后 单 
击 鼠 标 右键 ， 从 弹出 的 快捷 沫 单 中 选择 “布局 ”~ “水平 布局 ”。 


提示 


如 果 你 不 知道 如 何 选 择 这 个 布局 管理 器 ， 则 可 以 参考 图 11-3。 


Layout Alignment 


取消 QWidget 的 提升 
提升 的 窗口 部 件 .… 


AES... 


放 到 后 面 (8) 
放 到 前 面 (F) 


SHT) 
D ”复制 (C) 
5) RP) 


选择 全 部 (A) 
删除 (D) 


布局 


Ctrl+K 
Ctrl+L 


Ctrl+X 
Ctrl+C 


Ctrl+V 





verticalLayout 3 
scrollArea 


图 11-3 


或 者 单 击 右上 角 的 对 象 得 看 器 进行 选择 操作 ， 如 图 11-4 所 示 。 





“| 对 象 查看 器 a x 
| ws = 2 
v MainWindow QMainWindow 
v E centralwidget | QWidget 
Y scrollArea O QScrollArea 
v 图 scrollAreaWidgetContents 7] QWidget 
v & verticallayout_3 = QVBoxLayout 
Y tabWidget E QTabWidget 
>e_ AS Lol Midnan = 
Feild tease oF 


图 11-4 


这 时 发 现 widget_parameter tree 又 不 见 了 ， 需 要 设置 其 最 小 宽度 为 
100. 

(5) 单 击 scrollArea， 然 后 单 击 鼠 标 右键 ， 从 弹出 的 快捷 荣 单 中 选 
择 “ 布 局 ” “水 平 布局 ” (也 可 以 选择 “垂直 布局 ”>) ， 效 果 如 图 11-5 所 


ZN o 
人 至此， 我 们 就 完成 了 控件 级 别 的 布局 管理 。 





图 11-5 








窗口 级 别 的 布局 管理 ， 就 是 指 整 个 窗口 的 布局 由 布局 管理 器 接管 ， 
随 着 窗口 的 缩放 里 面 的 控件 也 会 跟着 缩放 。 

窗口 级 别 的 布局 管理 非常 简单 ， 相 对 于 控件 级 别 的 布局 管理 仅仅 多 
了 一 两 个 步骤 而 已 。 

单 击 窗 口 的 空白 处 ， 也 就 是 选中 MainWindow， 然 后 和 单 击 鼠 标 右 
键 ， 从 弹出 的 快捷 菜单 中 选择 “布局 ”-,“ 水 平 布 局 ”， 效 果 如 图 11-6 所 
示 。 





图 11-6 


通过 预览 ， 发 现 整 个 布局 会 随 着 窗口 大 小 的 变化 而 变化 。 至 此 ， 我 
们 的 目的 就 达到 了 。 

注意 

实际 上 ， 对 于 布局 管理 ， 并 没有 窗口 级 别 的 布局 管理 和 控件 级 别 的 
布局 管理 这 两 个 概念 。 之 所 以 提出 这 两 个 概念 ， 是 因为 有 些 人 不 知道 如 
何 用 布局 管理 器 接管 窗口 ， 导 致 设计 出 来 的 控件 不 能 随 着 窗口 大 小 的 调 
整 而 自动 缩放 。 

在 这 里 ”scrollArea 没有 显示 出 滚动 条 ， 是 因为 控件 的 高 度 还 不 够 
高 ， 设 置 widget_parameter_tree 的 最 小 高 度 为 1000， 就 可 以 看 到 滚动 条 
了 ， 如 图 11-7 所 示 。 
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图 11-7 


11.3 PYQt5ÆE MBSA I 














对 于 私 蔓 基金 公司 来 说 ， 不 管 公司 大 小 ， 都 需要 拥有 自己 的 投资 研 
完 系 统 ， 对 于 FOF 型 基金 来 说 更 是 如 此 。 上 所谓 FOF 型 基金 ， 耽 是 指 私募 
基金 公司 把 钱 投向 表现 比较 好 的 其 他 私募 公司 的 基金 产品 ， 把 这 些 基 金 
产品 进行 打包 ， 就 组 成 了 自己 的 基金 产品 。 因 此 ， 对 于 FoF 私 募 公司 来 
说 ， 其 投资 研究 系统 比较 重视 市 场 上 存在 的 基金 产品 信息 。 本 节 的 主要 
目的 就 是 教会 大 家 如 何 用 PyQt 去 呈现 某 种 基金 产品 的 信息 。 这 里 以 从 
公开 网 络 上 获取 一 种 基金 产品 的 数据 ， 如 私 葵 排 排 网 的 基金 产品 : 千石 
资本 -和 聚 光 明 1 号 资产 管理 计划 为 例 ， 网 址 为 : 
http://dc.simuwang.com/product/HF00000XEG.html。 需 要 注意 的 是 ， 打 开 
这 个 网 址 需要 注册 ， 如 果 你 不 想 注 册 的 话 ， 我 们 已 经 另存 了 一 份 后 组 
为 .mthml 的 离线 文件 ， 只 需 使 用 浏览 器 打开 即 可 。 

首先 ， 根 据 PyQt ”5 的 扩展 应 用 ， 介 绍 一 个 新 成 员 : ParameterTree 
类 。 这 个 类 实际 上 是 使 用 pyqtgraph 改写 的 QTreeWidget 的 子 类 。 但 是 
相对 于 QTreeWidget，ParameterTree 的 表现 更 美观 而 且 更 具有 实用 价 
值 。 下 面 的 示例 中 会 用 到 ParameterTree 类 。 

这 一 节 的 示例 使 用 上 一 节 设 计 的 结果 ， 我 们 先 看 一 下 示例 结果 ， 如 
图 11-8 所 示 。 
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图 11-8 


从 图 11-8 可 以 看 出 ， 左 侧 使 用 ParameterTree (QTreeWidget 的 子 
K) 来 显示 产品 基本 信息 ， 右 侧 从 上 到 下 使 用 四 个 QWebEngineView 类 
来 显示 产品 净值 与 沪 深 300 对 比 图 、 月 度 收益 图 、 区 间 收 益 图 、 回 撤 情 
况 图 。 本 节 将 重点 介绍 ParameterTree 的 使 用 方法 。 

我 们 发 现 图 11-8 所 示 的 图 片 的 大 小 与 上 一 节 设 计 的 大 小 不 一 样 ， 这 
是 因为 在 窗口 初始 化 时 手动 调整 了 窗口 控件 的 大 小 。 代 码 如 下 (本 例文 
件 名 为 PyQt5/Chapter11/fundFOF.py): 














qe mt el Darent = Non 


nun 


Constructor 


@param parent reference to the parent widget 
@type QWidget 


nnn 


super (MainWindow, self). init (parent) 


self.setupUi (self) 
self.plotly pyqt5 = Plotly PyQt5() 


' 7 手动 调整 窗口 控件 的 大 小 ， 使 之 看 起 来 更 美观 

self.widget parameter tree.setMaximumWidth (300) 
self.widget parameter tree.setMinimumWidth (200) 
self.QWebEngineView_ProductVsHs300.setMinimumHeight (500) 
self.tabWidget.setMinimumHeight (400) 


上 面 的 代码 非常 直观 ， 这 里 就 不 解释 了 。 下 面 看 ParameterTree 的 使 
用 方法 。 


'11 显 示 parametertree， 这 里 通过 布局 管理 器 把 ParameterTree 间接 地 谈 套 到 Widget 
窗 w 中 PEG 
from mypygtgraph import p 


from pyqtgraph.parametertree import ParameterTree 


t = ParameterTree () 

t.setParameters(p, showTop=False) 

t.setHeaderLabels(["##K", "S{i"]) 

# t.setWindowTitle('pyqtgraph example: Parameter Tree') 

layout = QtGui.QGridLayout () 

self.widget parameter tree.setLayout (layout) 

layout.addWidget ( 
QtGui .QLabel ("千石 资本 -和 聚 光 明 1 号 资产 管理 计划 基本 信息 ")，0，0，1，1) 
layout.addWidget (t) 


我 们 看 到 ， 这 里 的 代码 没有 说 明 如 何 使 用 数据 创建 成 树 。 关 键 代 码 


如 下 : 
from mypydtgraph import p 
t=ParameterTree() 
t.setParameters(p,showTop=False) 
mypyqtgraph 是 一 个 文件 ， 为 了 使 代码 简洁 、 可 读 性 好 ， 我 们 把 它 
放 在 另 一 个 文件 中 了 。 下 面 对 这 个 文件 进行 解读 《代码 见 
PyQt5/Chapter11/mypyqtgraph.py 文 件 ) 。 
首先 看 传 入 的 部 分 数据 。 


# 创建 参数 树 的 数据 
params = [ 
{'name': "EAk žie", 'type': 'group', 'children': I 
{'name': "SPH", "type’: 'float', value: -2.45, "siPrefix': 
Terie. ls Br Sl te: CRD 


{'name': Ria, 'type': "float", 'value': -2.72, "step': 0.1, 


wapro dr Ue te 

{'name': ' 最 近 净 值 日 期 '"，"'type': 'str', 'value': "2017-02-03"}, 

{'name': ， 最 新 净值 '"，"'type": "float", "value': 0.9728, ‘step’: 
Ql 

{'name': RHA, '‘type': 'float', 'value': 0.9728, 'step': 
Orona as 


## 创建 参数 树 


p = Parameter.create (name='params', type='group', children=params) 


结果 如 图 11-9 所 示 。 


参数 数值 


~ Pes 





今年 收益 -2.45 % 

累计 收益 -2.72% 

最 近 兆 值 日 期 2017-02-03 

最 新 兆 值 。 |0.993| a> 





累计 净值 。 0.973 











图 11-9 


我 们 看 到 ， 参 数 type': 'group' 对 应 的 是 树 的 分 文 ， 参 数 type': 'str 对 
应 的 是 lineEdit， 参 数 'type': float 对 应 的 是 doubleSpinBox。 

下 面 代码 的 作用 是 “数值 ” 那 一 列 的 任何 控件 的 value 发 生变 化 时 ， 
都 会 触发 change 函 数 ， 并 输出 变化 。 


HE 车 树 里 面 的 任何 内 容 发 生变 化 ， 则 输出 这 些 变 化 
def change (param, changes): 
print ("tree changes:") 
for param, change, data in changes: 
path = p.childPath (param) 
if path is not None: 
childName = '.'.join(path) 
else: 


childName = param.name() 


print(' parameter: %s' % childName) 
print(" change: $s" % change) 
pein (t datas $s' % str(data) ) 
Prine" SS ooo ») 


p.sigTreeStateChanged. connect (change) 


下 面 代码 的 作用 是 如 果 对 某 一 个 控件 的 value 撤 销 修改 ， 就 会 触发 
valueChanging cf 2X . 


def valueChanging(param,value): 


print("Value changing (not finalized):",param,value) 

# Too lazy for recursion: 

for child in p.children(): 
child.sigValueChanging.connect(valueChanging) 
for ch2 in child.children(): 

ch2.sigValueChanging.connect(valueChanging) 
欲 了 解 更 多 的 ParameterTree 使 用 方法 ， 可 以 参考 pyqtgraph 的 官方 示 
例 。 运 行 如 下 代码 ， 从 中 找到 ParameterTree 的 示例 。 
import pyqtgraph.examples 





pyqtgraph.examples.run() 
接 下 来 介绍 几 个 绘图 函数 。 
m Ae 显示 绘 py" 
self. QWebEngineView_ProductVsHs300.load( 
QUrl.fromLocalFile(self.plotly_pygt5.get_plotly_path_product_vs_hs: 
self. QWebEngineView_LagestBack.load(QUrl.fromLocalFile(self.r 
qt5.get_plotly_path_lagest_back())) 
self. QWebEngineView_PeriodReturn.load(QUrl.fromLocalFile(self 
self. QWebEngineview_MonthReturn.load(QUrl.fromLocalFile(self 
yqt5.get_plotly_path_month_return())) 
这 几 个 绘图 函数 的 使 用 方法 一 样 ， 意 思 是 用 QWebEngineView 类 实 
例 载 入 本 地 HTML 文件 。 注 意 
plotly_pyqt5.get_plotly_path_product_vs_hs3000 返 回 的 是 使 用 plotly 绘 图 
所 保存 的 HTML 文 件 路 径 。 
FEX} ”plotly_pyqt5.get_plotly_path_product_vs_hs3000 代 码 进 行 解 
读 〔( 代 码 见 PyQt5/Chapter11/Plotly_PyQt5.py 文 件 ) 。 


def get plotly path product vs hs300(self, 
file name='product_vs_ hs300.htm1'): 
path plotly = self.path dir plotly html + os.sep + file name 


data = pd.read_excel(r'data\#eRAW 1 F_hs300_merge.xlsx', 
index col=[0] ) 

data.rename _axis(lambda x: pd.to datetime(x), inplace=True) 

data.dropna (inplace=True) 


data = [ 
go.Scatter ( 


x=data.index, # assign x as the dataframe column 'x' 
y=data.cumulative nav, 


name=' 和 聚 光 明 1 号 ' 
), 


go.Scatter ( 
x=data.index, # assign x as the dataframe column 'x' 
y=data.close, 
name=' R 300' 
) 
] 
pyof.plot (data, filename=path plotly, auto open=False) 
return path plotly 


首先 获取 存储 HTML 文 件 的 路 径 。 
path_plotly=self.path_dir_plotly_html + os.sep + file_name 
data=pd.read_excel(r'data\ 和 聚 光 明 1 号 _hs300_merge.xlsx' 
index_col=[0]) 
然后 对 数据 进行 处 理 。 下 面 代 码 的 作用 是 把 data 数 据 索 引 设 置 成 日 
期 格式 以 及 去 掉 data 的 缺失 值 。 设 置 成 日 期 格式 的 好 处 是 绘图 库 会 自动 
调整 刻度 大 小 ， 而 不 是 在 坐标 轴 上 呈现 出 每 一 天 的 日 期 。 比 如 ， 如 果 
data 的 数据 跨度 是 10 年 ， 那 么 会 以 月 为 最 小 的 时 间 单 位 进行 绘图 ， 而 不 
是 以 日 为 最 小 的 时 间 单 位 。 
data.rename_axis(lambda x: pd.to_datetime(x),inplace=True) 


data.dropna(inplace=True) 





接 下 来 是 绘图 函数 ， 其 中 pyof.plot 的 参数 auto_open=False 表 示 绘 图 
完成 之 后 不 用 浏览 器 显示 绘图 结果 ; filename=path_plotly 表 示 将 HTML 
文件 保存 到 路 径 path_plotly 中 。 


data = [ 
go.Scatter ( 
x=data.index, # assign x as the dataframe column 'x' 
y=data.cumulative nav, 
name=' 和 聚 光 明 1 号 ' 
Ji 
go.Scatter ( 
x=data.index, # assign x as the dataframe column 'x' 
y=data.close, 
name=' 沪 深 300' 
) 
] 
pyof.plot(data, filename=path plotly, auto open=False) 
return path protiy 


OUR ADS Fe Ee Ain, M A EL Pik aN, FEB 
VOR RA OA ANSE CHG eB Fe Peep ma), ORR 
RA SME See OER. UREA Aa, tL AY AEA 
劳 排 排 网 上 抓 取 所 需要 的 产品 信息 ， 然 后 把 抓 取 到 的 数据 与 这 个 示例 进 
行 对 接 ， 这 样 你 就 拥有 一 个 mini 版 本 的 私募 排 排 网 的 客户 端 了 。 























对 于 机 构 来 说 ， 它 们 可 以 从 目 己 的 产品 信息 数据 库 中 筛选 出 一 些 优 
质 标的 〈 也 就 是 基金 产品 ) 。 但 是 对 于 投资 者 来 说 ， 他 们 不 像 机 构 那 么 
专业 ， 并 不 能 很 准确 地 识别 菜 一 种 基金 产品 的 好 坏 ， 也 没有 那么 多 的 时 
间 和 精力 去 市 场 上 寻找 适合 自己 投资 的 基金 产品 。 一 边 是 投资 者 想 要 找 
出 适合 自己 投资 的 基金 产品 ， 男 一 边 是 投资 者 没有 能 力 找 出 适合 自己 投 
资 的 基金 产品 ， 于 是 就 产生 了 信息 墙 塞 ， 其 表现 就 是 市 场 上 的 一 些 信息 
无 法 有 效 传递 到 投资 者 手中 。 而 机 构 正 好 和 擎 握 了 大 量 这 种 信息 ， 有 具有 信 




















恩 优 势 ， 于 是 机 构 可 以 利用 这 种 信息 优势 给 投资 者 提供 服务 ， 并 从 中 收 
取 服 务 费 用 。 

服务 的 方式 很 简单 ， 对 于 投资 者 来 说 ， 他 们 其 实 并 不 知道 适合 自己 
的 产品 是 什么 类 型 的 ， 但 是 可 以 预期 自己 的 风险 和 收益 。 于 是 就 产生 了 
另 一 个 问题 : 给 定投 资 者 的 预期 收益 与 风险 的 范围 ， 为 他 们 提供 最 优 的 
投资 方案 。 考 虑 到 风险 分 散 的 原则 ， 这 个 最 优 的 投资 计划 最 好 是 几 种 产 
品 的 组 合 。 

我 们 先 看 一 下 示例 结果 ， 如 图 11-10 所 示 。 
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图 11-10 


结果 分 为 两 个 部 分 ， 上 面部 分 是 让 用 户 选择 预期 收益 、 预 期 风险 以 
及 偏好 的 集 略 类 型 ， 截 图 如 图 11-11 所 示 。 


最 小 范围 ”最 大 范围 

收益 0.00 [o.o G 

aaam (0.70 elfo G 

sharp 比 [0.00 [E] {10.00 6 

O 管理 期 货 口 ] 事件 驱动 债券 策略 宏观 策略 口 ] 组 合 基 金 





开始 





图 11-11 


下 面部 分 是 从 数据 库 中 选取 数据 ， 并 通过 算法 找 出 最 优 的 产品 组 合 
以 及 各 目的 权重 ， 然 后 用 图 表 展 现 出 来 。 
提示 
出 于 安全 性 考虑 ， 这 里 只 提供 GUI 的 实现 逻辑 ， 而 不 会 提供 基金 产 
品 的 数据 库 ， 也 不 会 提供 找 出 最 优 产 品 组 合 的 算法 。 
对 于 使 用 Qt Designer 进 行 界面 设计 这 部 分 内 容 ， 这 里 不 再 介绍 ， 读 
者 可 以 参考 PyQt5/Chapter11/combination.ui 文 件 目 行 研 究 。 
本 例 涉及 的 代码 逻辑 并 不 复杂 ， 当 用 户 输入 预期 收益 和 预期 风险 范 
围 之 后 ， 单 击 “ 开 始 ? 按 钮 ， 就 会 触发 唯一 的 信号 模 机 制 。 
@pyatSlot() 
def on_pushButton_start_combination_clicked(self): 





TTTTTT 


TTTTTT 


strategy_list=self.check_check_box() 
self.check_check_box() A UH REEM FA ae FA ER EA EE 
求 ， 其 内 容 如 下 ， 意 思 是 在 strategy_list 中 放 入 已 经 选中 的 checkBox 的 名 
Fo 
def check_check_box(self): 
strategy_list=[] 


for each_checkBox in [self.checkBox_bond,self.checkBox_ 


combination_fund,self.checkBox_compound,self.checkBox_event,self 
x_future_manage,self.checkBox_macro,self.checkBox_relative_fund,self.cl 
ckBox_others,self.checkBox_others]: 

if each_checkBox.isChecked(): 
strategy_list.append(each_checkBox.text()) 
return strategy_list 

PMMA ATA se I ACR, FERRER AI A H A 
没有 金融 背景 ， 不 能 理解 ， 则 可 以 略 去 这 部 分 内 容 。 

当 所 选择 的 产品 分 类 数 大 于 3 和 小 于 1 时 都 不 合适 ， 会 弹出 警告 ， 并 
视 为 无 效 。 原 因 是 多 个 产品 分 类 《大 于 3) 的 组 合 由 于 产品 之 闻 的 多 重 
共 线 性 ， 会 导致 分 类 的 模型 在 数学 上 没有 最 优 解 ， 即 使 用 计算 机 暴力 算 
法 找 出 最 优 解 ， 其 权重 非 零 的 个 数 一 般 也 不 超过 3 个 。 所 以 经 过 综合 
夸 ， 限 制 产 品 分 类 数 为 1 一 3 是 最 合适 的 。 

strategy_list=self.check_check_box() 

















if len(strategy_list) > 3: 
print(' 最 多 选择 3 个 策略 ) 
QMessageBox.information(self," 注 意 "," 最 多 选择 3 个 策略 ") 
return None 
if len(strategy_list)==0: 
print(' 最 少 选 择 1 个 策略 ) 
QMessageBox.information(self," 注 意 "," 最 少 选 择 1 个 策略 ") 
return None 
接 下 来 设置 控件 的 大 小 和 获取 参数 信息 。 由 于 这 里 并 不 准备 把 参数 
言 奶 导入 数据 库 中 ， 所 以 只 是 简单 地 输出 参数 信息 。 
self.QWebEngineview_Combination monte_markovitz.setMinimumF 
self. QWebEngineview_Combination_Pie.setMinimumHeight(400) 
self. QWebEngineview_Combination_Table.setMinimumHeight(400) 


self. QWebEngineview_Combination_Versus.setMinimumHeight(700) 
print( k fm_min:',self.doubleSpinBox_returns_min.text()) 
print(‘W @m_max:',self.doubleSpinBox_returns_max.text()) 
print(' 最 大 回 撤 
_min:',self.doubleSpinBox_maxdrawdown_min.text()) 
print(' 最 大 回 撤 
_max:',self.doubleSpinBox_maxdrawdown_makx.text()) 
print(‘sharp Lt_min:',self.doubleSpinBox_sharp_min.text()) 
print(‘sharp Lt_max:',self.doubleSpinBox_sharp_max.text()) 
现在 假设 我 们 已 经 从 数据 库 中 找 出 3 种 组 合 最 优 的 产品 ， 分 别 为 : 
昆仑 三 十 六 号 、 时 时 安稳 健 1 号 和 长 城 国 瑞 证 券 恒通 23 号 ， 它 们 的 组 合 
权重 分 别 为 0.4、0.2 和 0.4。 
"假设 已 经 获取 产品 组 合 和 权重 " 
df=pd.read_excel(r'data\ 组 合 .xlsx',index_col=[0]) 
w=[0.4,0.2,0.4] 
df[' 组 合 ]=(df * w).sum(axis=1) 
最 后 就 是 绘图 了 ， 代 码 如 下 : 


self. QWebEngineview_Combination_monte_markovitz.load( 











QUrl.fromLocalFile(self.plotly_pyqt5.get_plotly_path_monte_markov 
monte_count=600))) 

self. QWebEngineview_Combination_Pie.load( 

QUrl.fromLocalFile(self.plotly_pygt5.get_plotly_path_combination_p 
df=df,w=w))) 

self. QWebEngineview_Combination_Versus.load( 

QUrl.fromLocalFile(self.plotly_pyqt5.get_plotly_path_combination_v 
us(df=df,w=w))) 

self. QWebEngineview_Combination_Table.load( 


QUrl.fromLocalFile(self.plotly_pyqt5.get_plotly_path_combination t: 
e(df=df,w=w))) 
上 面 的 绘图 函数 self.plotly_pyqt5.get_plotly_path_monte_markovitz 
对 应 的 图 相对 有 些 难 度 ， 下 面 简单 介绍 一 下 。 
通过 建立 随机 的 权重 来 进行 权 特 卡 洛 模拟 收益 率 和 方才 ， 然 后 依次 
计算 出 sharp 比 。 


def get plotly path monte markovitz(self, 
file name='monte markovitz.html',monte_count=400,risk free = 0.03): 





wen 
bath plotly = self-pach dir plotly hem t osisep, + file mame 
df = pd.read_excel(r'data\##@.xlsx', index col=[0]) 

returns = df.pet change) 

returns .dropna (inplace=True) 


noa = 3 


# 蒙特 卡 洛 随机 模拟 结果 
port returns = [] 


port_variance = [] 


for p in range(monte_ count): 
weights = np.random.random(noa) 


weights /= np.sum(weights) 
port_returns.append(np.sum(returns.mean() * 50 * weights)) # 加 


入 模拟 的 均值 
port _variance.append(np.sqrt(np.dot(weights.T, 
np.dot(returns.cov() * 50, weights)))) # 加 入 模拟 的 标准 差 


Pork returns = np larray (perk returns) 


port variance = np.array(port_variance) 
color_array = (port_returns - risk free) / port_variance # sharp tt, 


不 同 的 sharp 比 对 应 的 颜色 是 不 同 的 


接 下 来 对 收益 率 和 风险 进行 绘图 ， 并 且 不 同 的 sharp 比 对 应 不 同 的 
颜色 ， 即 颜色 是 可 变 的 ， 并 添加 colorbar。 


# 此 处 位 置 为 get plotly path monte markovitz 函数 内 部 





tracel = go.Scatter ( 
x- port variance, 
v= POCE recurs, 
mode='markers', 
marker=dict ( 
size='6', 
color=color_array, # 通过 一 个 可 变 的 变量 表示 颜色 ， 结 果 是 绘图 颜色 可 变 
colorscale='Viridis', 
# 设置 colorbar 
colorbar=dict ( 
tickmode='linear', 
tick0=color array.min(), 
dtick=(color array.max() - color array.min()) / 5, 
) ， 
showscale=True, 


) 
data = [tracel] 


pyof.plot(data, filename=path plotly, auto _open=False) 
return path _plotly 














我 们 发 现 这 部 分 内 容 与 “展示 产品 基本 信息 ”一 市 所 涉及 的 GUI 呈 现 
技巧 兰 不 多 ， 只 是 其 背后 的 逻辑 更 复杂 一 些 ， 而 这 些 稍微 复杂 的 多 辑 由 
于 不 是 本 书 的 重点 ， 所 以 都 没有 介绍 。 打 开 这 个 程序 ， 然 后 运行 ， 结 果 
会 看 到 使 用 QWebEngine View 所 绘制 的 图 表 是 如 此 的 美丽 ， 这 种 美丽 的 
动态 泻 染 图 在 其 他 GUI 程序 中 很 少 能 够 见 到 ， 而 且 它 的 设计 又 是 那么 的 
简单 ， 由 此 ， 在 内 心 深 处 对 PyQt 有 了 特别 的 喜爱 。 


11.4 PyQt 5 在 量 资中 的 应 


量化 投资 ， 简 单 地 说 ， 就 是 指 通过 计算 机 编程 的 方法 从 历史 数据 中 
找到 可 以 鳃 利 的 规律 ， 并 把 它 应 用 到 未 来 数据 上 ， 在 未 来 数据 上 实现 锰 
利 。 与 传统 投资 相 比 ， 量 化 投资 最 大 的 特点 是 在 投资 策略 中 广泛 地 应 用 
程序 化 思想 。 

虽然 量化 投资 的 核心 盘 利 策略 与 PyQt 没 什么 关系 ， 但 是 并 不 意味 着 
PyQt 束 不 能 应 用 于 量化 投资 中 。 实 际 上 ， 任 何 投资 策略 的 最 终结 果 都 需 
要 一 个 GUI 来 呈现 ， 这 就 是 PyQt 在 量化 投资 中 的 意义 。 根 据 笔者 的 经 
验 ， 投 资 策略 结果 的 GUI 呈现 只 适合 作为 回 测 平台 的 一 个 扩展 ， 如 果 
你 没有 开源 的 或 者 上 自己 写 的 回 测 平台 ， 那 么 就 没有 必要 为 每 个 投资 策略 
结果 都 单独 呈现 一 份 GUI， 那 样 做 无 异 于 浪费 时 间 。 

本 节 的 目的 是 给 现 有 的 回 测 平台 适 配 基 于 PyQt 的 GUI 输出 结 
由 于 本 书 使 用 的 是 Python 3+PyQt 5 的 本 地 开发 环境 ， 这 就 限制 了 市 场 上 
的 在 线 回 测 平台 以 及 基于 Python 2 的 本 地 回 测 平台 的 使 用 。 本 市 选择 给 
回 测 平台 zwquant 进 行 GUI 扩 展 ， 是 因为 zwquant 免 费 且 开源 ， 文 持 
Python 3， 而且 简 单 、 易 于 上 手 ， 整 个 回 测 平 人 台 仅仅 由 几 个 .py 文件 构 
成 。 

目前 zwquant 只 发 布 了 第 1 版， 其 中 有 很 多 细 市 不 够 完善 ， 本 书 提 
供 的 Chapter11/zwquant_pyqt 增 加 了 对 GUI 输 出 的 支持 ， 调 整 了 一 些 细 
节 ， 使 之 更 容易 扩展 和 使 用 。 

运行 PyQt5/Chapter11/zwquant_pyqt/zq902_macd_v2.py 文 件 ， 结 果 如 
图 11-12 所 示 。 
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图 11-12 


这 是 对 zwquant 适 配 GUI 扩 展 的 界面 ， 下 面 对 这 个 界面 进行 解读 。 
在 默认 情况 下 ， 是 不 显示 GUI 界面 的 ， 要 开局 这 个 GUI 界面 的 显 
示 ， 首 先 需 要 对 策略 参数 进行 如 下 设置 : 
# 设置 策略 参数 
qx.staVars=[12,26,'2015-01-01',"] 
qx.debugMod=1 
qx.pyqt_mode_flag=True 
dqx.staFun=zwsta.macd20# 绑 定 策略 函数 区 运行 回调 主 函 数 
其 中 ，qx.pyqt_mode_flag==True 就 是 指 要 开启 GUI 输出 模式 。 如 
果 设 置 了 qx.pyqt_mode_flag==True， 在 bt_endRets 函 数 中 会 执行 下 面 的 





代码 : 
# 自 定义 输出 结果 
if qx.pyqt_mode_flag==True: 
zwdr.my_pyqt_show(qx) 
else: 
zwdr.my_qunt_plot(qx) 
zwdr.my_pyqt_show() 对 应 的 
PyQt5/Chapter11/zwquant_pyqt/zwQTDraw.py 文件 的 my_pygqt_showOE 
数 如 下 : 
def my_pygt_show(qx): 


BA 


from my_back_test_show import MainWindow 

from PyQt5.QtWidgets import QMainWindow, QApplication 

import sys 

app=QApplication(sys.argv) 

ui=MainWindow(qx) 

ui.showMaximized() 

# ui.show() 

sys.exit(app.exec_()) 

这 个 函数 其 实 是 在 运行 

PyQt5/Chapter11/zwquant_pyqt/my_back_test_show.py， 这 个 文件 才 是 本 
节 要 介绍 的 重点 。 





def init (self, qx=None, parent=None) : 


woe 


Constructor 


@param parent reference to the parent widget 
@type QWidget 


nun 


super (MainWindow, self). init (parent) 
self.setupUi (self) 
if qx != None: # 5 zwquant #4, qx Æ zwquant 的 一 个 类 实例 


self.qx = qx 
selftshow result (self gx) 


self.matplotlibwidget static.mpl.start static plot(self.qx) 
else: # 用 于 测试 ， 不 需要 zwquant 也 能 运行 ， 方 便 快 速 开 发 自己 的 GUI 界面 


self .show result () 


self.matplotlibwidget_static.mpl.start_static_plot() 


上 面 是 MainWindow 类 的 初始 化 函数 ， 无 论 是 与 zwquant 结 合 还 是 
独立 运行 ， 都 会 执行 show_resultO0 和 
matplotlibwidget_static.mpl.start_static_plot() PA 2. 


def show_result (self, qx=None): 


if qx != None: # 跑 回 测 的话 就 传 入 回 测 数据 
list result = qx.result info 
pickle file = open('my list.pkl', 'wb') # 以 wh 方式 写 入 
pickle.dump(list_result, pickle file) # 向 pickle file PEA 
my list 
pickle file.close () 
else: # 不 跑 回 测 的 话 就 读 取 测试 数据 
pickle file = open('my list.pkl', 'rb') # WU rb FARR 
list_result = pickle.load(pickle file) # 读 取 以 pickle FARAH 
文件 pickle file 





pickle file.close () 


list_result.append(['', '']) # AT RBAB 24*2 (原来 是 23*2) 

len index = 6 

len col = 3 

tisto, Listi, Ivest2, dstS = [lest result [6 * a6 = a 6] for so in 
range (0, 4) ] 

arr result = np.c¢oncatenate ([list0, listl, list2, list3], axis=1) 

self.tableWidget.setRowCount (len_index) # 设置 行 的 数量 

self.tableWidget.setColumnCount (len col) # 设置 列 的 数量 

self.tableWwidget.setHorizontalHeaderLabels([' 回 测 内 容 '，' 回 测 结 果 '] * 
4) # 设置 重 直 方向 上 的 标题 

self.tableWidget.setVerticalHeaderLabels([str(i) for i in range(1， 
len index + 1)]) # 设置 水 平方 向 上 的 标题 


for index in range(len_ index): 
for col in range(len col): 
self.tableWidget.setItem(index, col, 
QTableWidgetItem(arr result[index, col])) 
self.tableWidget.resizeColumnsToContents ()# 根据 内 容 来 调整 列 的 宽度 


show_resultO 函 数 用 来 建立 一 个 tableWidget， 由 于 代码 注释 非常 详 
细 ， 这 里 就 不 过 多 介绍 了 。 结 果 如 图 11-13 所 示 。 

fF PyQt5/Chapter1 1/zwquant_pygt/MatplotlibWidget.py' 7 HZ Alek 
数 ， 同 样 有 与 zwquant 结 合 和 独立 运行 两 个 版 本 。 需 要 注意 的 是 ， 
ax2=ax1.twinx() 表 示 ax2 建 立 的 是 次 坐标 轴 ， 在 次 坐标 轴 上 显示 组 合 市 值 








曲线 ， 在 主 坐 标 轴 上 显示 当前 市 值 的 收益 率 情 况 。 
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图 11-13 


' 1 绘制 静态 图 ， 可 以 在 这 里 定义 自己 的 绘图 逻辑 '' 


def start static plot (self, qx=None) : 

if qx != None: # 5 zwquant 434, qx 是 zwquant 的 一 个 类 实例 
df = qx.qxLib.copy () 
df.set_index('date', inplace=True) 
df.rename axis(lambda x: pd.to datetime (x),inplace=True) 
axl = self.axes 
axl.plot(df['dret'], color='green', label='dret', linewidth=0.5) 
axl.legend(loc='upper left') 
ax2 = axl.twinx() 
ax2.plot(df['val'], color='red', label='val', linewidth=2) 
ax2.legend(loc='upper right") 

else:# 用 于 测试 ， 不 需要 zwquant 也 能 运行 ， 方 便 快 速 开 发 自己 的 GUI 界面 
È arange (0-0; 3.0, 0.01) 


S = SI012 % pi * i) 


ll 


self.axes.plot(t, s) 
self.axes.set ylabel(' 静 态 图 : Y 轴 ') 
self.axes.set xlabel(' 静 态 图 : X 轴 ') 


self.axes.grid(True) 


结果 如 图 11-14 所 示 。 
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图 11-14 





对 于 剩 下 的 三 个 “得 看 ”按钮 ， 单 击 后 分 别 用 来 得 看 对 应 的 文件 ， 在 
PyQt5/Chapter11/zwquant_pyqt/tmp 文件 夹 中 可 以 找到 这 三 个 文件 ， 分 别 
是 macd20_600401.csv、macd20_gxLib.csv 和 macd20_xtrdLib.csv。 


@pygqtSlot () 
def on_pushButton_show dataPre clicked(self): 


woe 


Slot documentation goes here. 


if hasattr(self, 'qx'):# 4 zwquant 结合 ， 再 进行 下 一 步 
if Nasattr(sel fqn, ‘path ‘dataPrre!); 
os.system(np.random.choice(self.qx.path_dataPre)) # 随机 选取 
数据 预 处 理 的 文件 结果 ， 并 打开 


@pyqtSlot () 


def on pushButton show money flow _clicked(self): 


nnn 


Slot documentation goes here. 


if hasattr (self, 'qx'):# 5 zwquant 结合 ， 再 进行 下 一 步 
os.system(self.qx.fn_qxLib) 


@pygqtSlot () 
def on_pushButton_show trade flow _clicked(self): 


nun 


Slot documentation goes here. 


if hasattr (self, 'qx'):# 5 zwquant 结合 ， 再 进行 下 一 步 
os.system(self.qx.fn_ xtrdLib) 





在 这 里 并 没有 看 到 最 后 一 个 按钮 〈 隐 藏 输出 结果 ) 的 代码 ， 但 是 这 
个 按钮 确实 触发 了 信号 槽 机 制 。 其 实 这 部 分 内容 是 在 Qt Designer 中 完成 
的 ， 方 法 如 下 : 

首先 ， 对 这 个 按钮 的 属性 进行 设置 ， 如 图 11-15 所 示 。 


pushButton hide output : QPushButton 
属性 值 
> iconSize 16 x 16 
> shortcut 
checkable 加 
checked 
autoRepeat E 
autoExclusive [] 














图 11-15 


然后 ， 单 击 “Edit” > “编辑 信号 与 槽 >， 将 隐藏 输 出 结果 按钮 拖 动 到 
tableWidget 上， 则 会 弹出 一 个 对 话 框 ， 设 置 如 图 11-16 所 示 。 
单 击 “OK” 按 钮 ， 就 看 到 了 如 图 11-17 所 示 的 结果 。 





y 配音 连接 - Qt Designer 
pushButton_hide_output (QPushButton) tableWidget (QTable¥idget) 
| clicked0 a resizeRowsToContents() 

clicked(bool) scrollToBottom() 
customContextMgnuRequested(QPoint) scrollToTop() 

destroyed() selectAll() 
destroyed(QObj¢t") setDisabled(boo!) 
objectNameChargyed(QString) 
pressed() 


released() 

toggled(bool) 
windowlconChanged(Qicon) 
windowlconTe anged(QString) setWindowModitied(bool) 
windowTitleChanged(QString) show/() 





iE WR... 


META gidget 继承 的 信号 和 楼 





图 11-16 


clicked(bool 





图 11-17 





上 面 的 信号 与 槽 对 应 的 代码 如 下 : 

self.pushButton_hide_output.clicked['bool'].connect(self.tableWidget.: 

可 以 看 到 ， 连 这 样 的 代码 Qt Designer 都 已 经 帮 有 我 们 生成 了 ， 由 此 可 
见 它 的 强大 之 处 。 男 外 ， 如 果 读 者 在 学 习 PyQt 时 不 知道 茶 个 控件 有 哪 
些 信号 与 槽 ， 一 是 通过 Qt 官网 来 找 ;， 二 是 通过 这 种 方法 生成 。 不 过 ， 
这 种 方法 只 适用 于 PyQt 对 已 经 存在 的 信号 与 槽 进行 连接 的 情况 ， 如 果 
想 要 目 定义 信和 号 与 槽 ， 还 是 要 参考 本 书 中 73 Ta SoM mae 
oe 

最 后 ， 之 所 以 要 把 绘图 结果 骸 套 到 scrollArea 中 ， 是 为 了 方便 日 后 
往 里 面 添加 更 多 的 信息 。 因 为 一 个 成 熟 的 量化 投资 平台 的 输出 结果 不 仅 
仅 包含 几 个 指标 、 几 个 图 示 ， 还 可 能 会 输出 一 些 交 易 信 息 、 每 日 推荐 股 
票 ， 以 及 显示 市 场 行情 信息 等 。 加 上 scrollArea， 是 为 了 方便 日 后 能 够 快 
速 添加 这 些 信息 ， 不 需要 的 读者 可 以 根据 上 自己 的 情况 自行 删除 。 



































金融 行业 之 所 以 能 够 获取 骏 利 ， 最 根本 的 原因 是 它 是 一 个 资金 融通 
的 中 介 ， 把 资金 从 创造 价值 增值 能 力 低 的 主体 转移 到 创造 价值 增值 高 的 
主体 上 来 。 主体 又 可 以 分 为 国家 、 行 业 、 公 司 和 个 体 户 。 由 于 个 体 户 的 
资金 增值 容量 有 限 ， 且 信息 很 难 获 取 ， 因 此 我 们 排除 个 体 户 ， 主 要 分 析 
的 基本 单位 就 是 公司 。 对 于 个 人 投资 者 来 说 ， 从 公开 信息 中 获取 公司 基 
本 情况 的 途径 可 能 有 免费 的 新 浪 财 经 网 页 、 同 人 花 顺 、 大 智 臣 等 炒股 软 
件 ， 不 差 钱 的 也 可 以 使 用 付费 的 Wind 金融 终端 ; 而 对 于 机 构 这 样 的 专 
业 投 资 者 ， 在 分 析 公 司 好 坏 时 不 仅 需要 使 用 这 些 信息 ， 还 需要 从 公司 发 
布 的 各 种 报告 中 挖掘 出 隐藏 的 信息 。 因 此 ， 如 何 快 速 、 高 效 地 获取 各 种 
报告 中 的 信息 对 机 构 投资 者 来 说 是 一 个 难题 ， 本 节 的 内 容 就 是 要 解决 这 
个 难题 。 

虽然 可 以 从 同花顺 、 大 智慧 以 及 Wind 金融 终端 中 获取 公司 报告 ， 
但 是 这 些 报告 需要 一 个 个 获取 ， 效 率 太 低 了 ， 因 此 这 些 软件 并 不 是 我 们 
想 要 的 。 

本 节 给 出 的 做 法 是 用 PyQt 模 拟 巨 潮 资讯 
(http://www.cninfo.com.cn/cninfo-new/index) 网 站 ， 来 实现 我 们 想 要 的 
各 种 功能 。 为 什么 要 设计 一 个 GUI 而 不 直接 使 用 现成 的 网 页 搜索 呢 ? 这 
是 因为 这 个 网 站 的 公告 信息 同样 需要 一 个 个 点 击 获取 ， 不 够 智能 ， 实 现 
不 了 我 们 想 要 的 功能 。 

这 个 案例 是 笔者 在 国内 一 家 大 型 的 证 券 公司 工作 期 间 开 发 的 一 个 快 
速 获取 公司 公告 的 工具 ， 并 有 一 经 问世 束 受 到 了 业界 的 好 评 。 该 案例 具 
有 完整 性 和 实战 性 ， 无 须 修改 就 可 以 使 用 。 说 实话 ， 对 于 这 样 一 个 工 



































共 ， 在 金融 行业 绝对 会 有 人 人 花 遍 价 来 购买 ， 特 别 是 与 公司 报告 接触 最 多 
的 研究 员 ， 最 希望 能 拥有 这 样 的 工具 。 笔 者 把 这 个 软件 放 进 本 书 中 ， 也 
算是 对 读者 购书 的 一 种 答谢 。 软 件 虽 然 很 简单 ， 但 是 背后 的 馆 辑 却 很 烦 
琐 ， 人 代码 比较 多 ， 新 手 可 能 一 下 子 看 不 懂 ， 建 议 新 手 积累 一 点 PyQt 经 验 
后 再 去 深入 学 习 。 下 面 我 们 看 其 体 的 细 市 部 分 。 


11.5.1 E R it ie 


这 个 GUI 案例 的 功能 主要 是 用 来 模拟 网 站 的 行为 ， 因 此 最 底层 调用 
I EENKEER, GU 仅仅 是 对 爬虫 的 结果 封装 一 个 壳 而 已 。 这 里 不 
会 对 爬虫 知识 进行 深入 讲解 ， 只 介绍 如 何 调用 已 经 写 好 的 爬虫 程序 。 

在 PyQt5/Chapter11/juchao/craw.py 文 件 中 ， 我 们 只 看 到 了 一 个 简单 
的 函数 : 


模拟 巨 潮 资讯 的 网 络 扑 中 。 


import requests 


def get one page data(key, date start="', date end="", fulltext str 
flag='false', page num=1, pageSize=30,sortName='"nothing',sortType="desc'): 
mee 
:param key: 搜索 的 关键 词 
:param date _ start: 起 始 时 间 
:param date end: 终止 时 间 


:param fulltext str flag: 是 否 是 内 容 搜索 ， 默 认为 false， 即 标题 搜索 
:param page num: 要 搜索 的 页 码 
:param pageSize: 每 页 显示 的 数量 
:param sortName: 排序 名 称 ， 对 应 关系 为 :' 相 关 度 ': 'nothing'，' 时 间 ': 
'pubdate'，' 代 码 ': 'stockcode cat'， 黑 认为 相关 度 
:param sortType: 排序 类 型 ， 对 应 关系 为 : "升序 !: 'asc'，' 降 序 ': 'desc', BR 
认为 降序 
:return: 总 页 码 和 当前 页 码 的 信息 
tre 
params = {'searchkey': key, 
"sdate': date start, 
"edate': date end, 
‘isfulltext': fulltext str flag, 
"sortName': sortName, 
"sortType': sortType, 
‘pageNum': str(page num), 
"pageSize': str(pageSize) } 
key encode = requests.models.urlencode({'a': key}).split('=") [1] 


url = 'http://www.cninfo.com.cn/cninfo-new/fulltextSearch/full' 
headers = {'Accept': 'application/json, text/javascript, */*; q=0.01', 

‘Accept-Encoding': ‘gzip, deflate, sdch', 

"Accept-Language': 'zh-CN,zh;q=0.8', 

"Connection': 'keep-alive', 

"Cookie': 'JSESSIONID=7DF993E8D803E8672C6069F48399F60D; 
cninfo search record cookie=%s' % key encode, 

"Host': 'www.cninfo.com.cn', 

"Referer': 'http://www.cninfo.com.cn/cninfo-new/fulltext 
Search?code=&notautosubmit=&keyWord=%s' % key encode, 

"User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) 
AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36 
Qiyu/2.1.0.0', 'X-Requested-With': 'XMLHttpRequest'} 

try: 
r = requests.get (url, headers=headers, params=params, timeout=20) 
# r.encoding = 'utf-8' 
page content = r.json() 
page value = page content['announcements'] 
total page num = page content['totalpages'] 
return total page num, page value 
except: 
return None, None 


if name == ' main _— 
total_num, page value = get_one page data(' 中 国 中 车 '， 
date start="2015-01-05', date end="2015-07-03') 


可 以 看 到 ， 这 个 函数 传递 的 参数 功能 很 详细 ， 这 些 参 数 可 以 模拟 从 
网 页 中 所 能 获取 的 全 部 信息 (模拟 的 网 页 为 : 
http://www. cninfo.com.cn/cninfo-new/fulltextSearch? 
code=&notautosubmit=&keyWord="# H FÆ) 。 唯 一 不 同 的 是 ， 这 里 返 
Ba 示 30 条 信息 (pageSize=30) ， 而 官方 网 站 则 只 能 每 页 显示 
10 条 信息 。 在 如 此 复杂 的 网 站 背后 却 是 这 样 一 个 简单 的 函数 ， 疏 虫 给 人 
的 感觉 是 LATE \ 议 的 。 读 者 可 以 自行 修改 参数 ， 看 看 结果 与 官方 网 站 的 
结果 是 否 一 致 ， 以 便 对 这 个 爬虫 有 一 个 大 概 的 了 解 。 


11.5.2 程序 解读 




















1.Qt Designer} [ff] 

本 节 案 例 使 用 的 UI 界 面 文件 是 PyQt5/Chapter1Ljuchaomun.ui。 可 以 
看 到 上 面 爬 虫 的 所 有 参数 在 这 个 界面 中 都 有 相对 应 的 控件 ， 剩 下 的 一 些 
控件 则 是 我 们 对 巨 潮 资讯 的 扩展 ， 如 网 11-18 所 示 。 
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图 11-18 


2. 软 件 的 初始 化 

软件 的 初始 化 包括 三 个 部 分 : 设置 属性 、 连 接 信和 号 与 槽 、 初 始 化 下 
载 目 录 。 

对 于 属性 的 设置 ， 需 要 注意 的 是 self.frame_advanced.hide()， 表 示 默 
认 隐 藏 高 级 选项 的 内 容 ， 因 为 这 些 高 级 选项 已 经 放 在 了 一 个 frame 控 件 
中 。 

对 于 信号 与 槽 的 连接 ， 这 部 分 内 容 比较 难 理解 ， 会 在 后 续 拆 分 进行 
讲解 。 


dei init (selt, parent—None))|: 


Constructor 


@param parent reference to the parent widget 

@type QWidget 

nun 

super (MainWindow, self). init (parent) 

self.setupUi (self) 

Self.total pages content = 1 

self.total pages title = 1 

self.current page num title = 1 

self.icurrent page num content. = 1 

self.sort type = “desc’ 

self.sort_name = 'nothing' 

self.comboBox dict = {' 相 关 度 ': 'nothing', 时间: "pubdate', 'KA': 
"stockeode cat’, "IA": ‘asc', "MAR: desc’) 

self.frame_advanced.hide() # 默认 隐藏 frame 

self.download_info_list=[] # 存储 要 下 载 的 信息 ， 每 个 元 素 都 是 字典 形式 的 ， 
存储 了 要 下 载 的 标题 、URL 等 信息 

self.download_path = os.path.abspath(r'./F#R"') 

self.label show path.setText(' 当 前 保存 目录 为 : ' + self.download_path) 

self.tableWidget title checked = Qt.Unchecked # 设置 tableWidget 的 
默认 选择 方式 

self.tableWidget content checked = Qt.Unchecked 

self.select title page info = set() # 记录 checkBox select 选择 的 页 面 


self.select_content_page info = set()# 记录 checkBox_select 选择 的 页 面 


self.filter title list = [] + 用 来 显示 过 滤 标 题 的 列表 
self.filter_content_list = [] + 用 来 显示 过 滤 内 容 的 列表 


'! 下面 四 行 代码 一 定 要 按照 顺序 执行 ,否则 self.start_time 与 self.end_time 这 
两 行 代码 会 无 效 ! 1 


self.dateEdit.setDateTime (datetime.datetime.now() ) 


self.dateEdit_2.setDateTime (datetime.datetime.now() ) 
self.start time = !' 
self.end time = '' 


self.dateEdit.setEnabled (False) 
self.dateEdit_2.setEnabled (False) 
self.comboBox_type.setEnabled (False) 
self.comboBox name.setEnabled (False) 
self.lineEdit filter content.setEnabled (False) 
self.lineEdit filter title.setEnabled (False) 


' "连接 信号 与 楼 ' '， 

' 显示 或 隐藏 高 级 选项 ' 

self.pushButton setting _advanced.toggled['bool'"] .connect 
(self.frame advanced.setHidden) 

FR! 

self.pushButton download select title.clicked.connect 
(self.download pdf) 

self.pushButton download select _content.clicked.connect 
(self.download pdf) 

download thread.signal.connect(self.show_status) # 子 线程 的 信号 连接 
主线 程 的 楼 

' 修 改 存储 路 径 " 

self.pushButton change save path.clicked.connect 
(self.change save path) 

'tableWidget 相关 ' 

self.tableWidget title.itemChanged.connect (self.select item) 

self.tableWidget content.itemChanged.connect (self.select item) 

self.tableWidget title.cellClicked.connect (self.view one new) 

self.tableWidget content.cellClicked.connect (self.view one new) 

"KEELE 

self.signal_status.connect(self.show status) # HRA 5 pA 

'# lineEdit 控件 上 按 下 Enter 键 就 可 以 触发 搜索 或 跳 转 到 页 码 ， 

self.lineEdit.returnPressed.connect (self.on_pushButton_ search 
clicked) 

self.lineEdit filter title.returnPressed.connect (self.on_ 
pushButton_search clicked) 

self.lineEdit filter content.returnPressed.connect 
(self.on_pushButton_ search clicked) 

self.lineEdit_content_page.returnPressed.connect 
(self.pushButton content jump to.click) 

self.lineEdit_ title page.returnPressed.connect (lambda: 


self 


self. 


self 


self. 


self. 


self 


self 


(sel 


(sel 


(sel 


(sel 


.Page go('title jump to')) 
' 页 码 跳 转 函数 ， 
self.pushButton title down.clicked.connect (lambda: 
page go('title down')) 
self.pushButton content down.clicked.connect (lambda: 
-page_go('content_down') ) 
self.pushButton_ title up.clicked.connect (lambda: 
pags go Citable \))) 
self.pushButton_ content_up.clicked.connect (lambda: 
page go('content_ up')) 
self.pushButton title jump to.clicked.connect (lambda: 





-_page_go('title jump: to") ) 

self.pushButton_content_ jump _to.clicked.connect (lambda: 
«page go('content jump _to')) 

' 选择 标 题 或 内 容 ' 

selt checkbox select title clicked | bool" | connect 
f.select_checkBox) 

self.checkBox select content.clicked| 'bool'] -connect 
f£.select checkBox) 

' 显示 /下 载 过 滤 操 作 ， 

self.checkBox filter title.clicked['bool'].connect 
£ ti leer enable) 

selt.checkBox filter content.clicked|'bool'] -connect 
f filter enable) 


! 初 始 化 下 载 目录 ' 
if not os.path.isdir(self.download path): 
os.mkdir(self.download path) 


3. 开 始 搜索 


打开 软件 ， 在 文本 框 中 输入 关键 词 ， 然 后 单 击 “搜索 ”按钮 ， 


信号 模 机 制 。 


@pyatSlot() 
def on_pushButton_search_clicked(self): 


Slot documentation goes here. 


触发 了 


Wt 


self.download_info_list=[}# 每 一 次 重新 搜索 都 要 清空 下 载 购 物 
Æ 
self.current_page_num_title=1 # 初始 化 搜索 ， 默 认 当 前 页 码 为 1 
self.current_page_num_content=1 
self.update_tablewidget_title() # 更 新 标题 搜索 
self.update_tablewidget_content() # 更 新 内 容 搜索 
其 实 不 仅 单 击 按钮 时 需要 触发 这 个 槽 冰 数 ， 在 文本 框 中 按 下 Enter 
键 时 也 需要 触发 这 个 槽 函数 ， 于 是 就 生成 了 如 下 代码 〈 在 _init 函数 
中 ) : 








在 lineEdit 上 按 下 Enter 键 就 可 以 触发 搜索 或 跳 转 到 页 人 码 ' 
self.lineEdit.returnPressed.connect(self.on_pushButton_search_clicl 
self.lineEdit_filter_title.returnPressed.connect ) 
(self.on_pushButton_search_clicked) 
self.lineEdit_filter_content.returnPressed.connect 
(self.on_pushButton_search_clicked) 
上 面 的 代码 表示 无 论 是 在 搜索 的 lineEdit 中 还 是 过 滤 的 ”lineEdit 
中 ， 只 要 按 下 Enter 键 ， 融 会 触发 这 个 槽 函数 。 这 里 使 用 了 两 种 方法 来 连 
接 信号 与 槽 ， 其 中 一 种 方法 很 音 见 ， 束 是 用 Eric 生 成 的 信号 与 槽 连接 ; 
另 一 种 方法 则 是 自 定 义 的 信号 与 槽 连接 。 下 面 还 会 介绍 更 多 的 连接 方 
法 ， 比 如 传递 参数 。 
接 下 来 分 析 这 个 槽 函数 ， 可 以 看 到 ， 初 始 化 按钮 除 更 新 一 些 初 始 化 
参数 外 ， 下 面 两 行 代码 起 关键 作用 : 
self.update_tablewidget_title() # 更 新 标题 搜索 
self.update_tablewidget_content() # 更 新 内 容 搜 索 
update_tablewidget_title 和 update_tablewidget_content 的 功能 本 质 上 是 
一 样 的 ， 下 面 以 update_tablewidget_title 为 例 : 











def update tablewidget title(self, page num=1): 
''' f tablewidget_title''' 


key word = self.lineEdit.text () 
"ARBRE RP RRA ' 


total pages title, dict data title = get one page data(key word, 


fulltext str flag='false', page num=page num, 
date start—self.start time, date end=self end time, 


sortName=self.sort name, sortType=self.sort type) 


' "把 数据 显示 到 表格 上 '! 
if total pages, title t= None: 
self.total pages title = total pages title 


self.show tabliew1dger (dict data tithe, self.tableWidgėt title, 
clear fore-ralse) 


self.label page info title.setText('%sd/%d' % 
(self.current_page num title, self.total_ pages title)) # 更 新 当前 页 码 信息 


可 以 看 到 ，update_tablewidget title 主 要 包括 两 部 分 ， 第 一 部 分 是 从 
网 页 中 获取 信息 ; 第 二 部 分 是 把 从 网 页 中 抓 取 的 信息 显示 到 表格 上 ， 主 
要 使 用 Show_tablewidget 函 数 ， 而 self.label_page_info_title.setText 函数 则 


用 来 显示 当前 页 码 信息 。 下 面 看 一 下 show_tablewidget 函 数 ， 它 是 本 节 
中 最 重要 的 函数 ， 我 们 拆 分 成 几 部 分 来 解读 。 





def show tablewidget (self; dict data, tableWidget, clear fore=True): 
'''4EX dict data 4 tableWidget, UKM# tableWidget 上 面 呈 现 
dict datas.: 
' 提取 自己 需要 的 信息 : ''' 
if clear fore == True: # 检测 在 搜索 之 前 是 否 要 清空 下 载 购物 车 信息 
self.download info list = [] 








之 所 以 检测 是 否 要 清空 下 载 购 物 车 信息 ， 是 因为 我 们 调用 的 
Show _tablewidget 函 数 是 页 码 跳 转 函数 ， 比 如 单 击 “ 下 一 页 ”按钮 时 ， 我 们 
希望 的 是 保留 下 载 购物 车 的 信息 。 而 新 建 一 个 搜索 〈 单 击 “ 搜 索 ” 投 


钮 ) ， 则 表示 需要 清空 下 载 购物 车 的 信息 。 
每 一 次 页 码 跳 转 或 者 新 建 搜索 时 都 应 该 清空 状态 栏 的 内 容 ， 所 以 会 
有 下 面 的 代码 。 
# 此 处 位 置 在 函数 show_tablewidget 内 部 
更 新 状态 栏 信息 ' 
self.signal_status.emit(‘clear’,[]) # 清空 状态 栏 
我 们 希望 这 个 软件 能 够 把 之 前 选中 的 页 面 记 录 下 来 ， 并 在 下 一 次 跳 
转 到 这 些 页 面 时 能 够 自动 选中 它们 。 这 个 功能 网 络 爬 虫 是 无 法 实现 的 ， 
需要 用 代码 手动 实现 。 








# 此 处 位 置 在 函数 show tablewidget 内 部 
' 检 测 checkBox 之 前 是 否 被 选中 过 ， 若 选中 过 则 设置 为 选中 ， 和 否则 设置 为 不 选中 
If tapilewidget objectName W == ESNEeWgsEECSeSs 
if Self. Curent page num title in 


self.select title page info: 





self.checkBox select title.setCheckState (Qt.Checked) 

else: 
self.checkBox select title.setCheckState (Qt .Unchecked) 

flag = 'title' 

Be 
if self.current_page num content in 
Selt Select content paga unto: 

self.checkBox_ select _content.setCheckState (Qt.Checked) 


else: 


self.checkBox select content.setCheckState (Qt.Unchecked) 


flag = 'content' 





对 于 过 滤 信 息 的 显示 ， 我 们 放 在 “ 自 定 义 过 小 ”部 分 进行 讲解 ， 这 里 


# 此 处 位 置 在 函数 show tablewidget 内 部 
BA It EB RAISE 
if self.lineERdit filter title.isEnabled() == True: 
filter text = self. dimnetidit filter title text) 
self. filter title list = "Self qet filter waist (i item text) 
elso: 
selbe piper Cible Mst=i] 
de self: lineEdit Tilter rontent.-isbnabled i == True: 
filter text = self.lineEdit filter content.text() 
self.filter content list = selfi.get filter list (filter text) 


else: 





self.filter content list=[] 


接 下 来 处 理 从 网 络 中 获取 的 数据 。 需 要 说 明 的 是 ， 我 们 为 结果 自 定 
义 添加 了 标记 : dict_target['flag']=flag。 之 所 以 这 样 做 ， 是 因为 服务 器 返 
回 的 标题 搜索 结果 与 内 容 搜 索 结 果 有 相同 的 内 容 。 如 果 把 这 些 相同 的 内 
容 添 加 到 下 载 购 物 车 中 ， 则 无 法 明确 下 载 购 物 车 中 的 基本 元 素 到 底 是 来 
自 于 标题 搜索 还 是 内 容 搜 索 ， 这 样 就 无 法 建立 下 载 购 物 车 与 标题 搜索 和 
内 容 搜索 之 间 一 一 对 应 的 关系 ， 不 方便 管理 购物 车 。 而 加 上 标记 之 后 ， 
就 可 以 实现 一 一 对 应 的 关系 了 。 











# 此 处 位 置 在 函数 show tablewidget 内 部 


"DRAM ABR RAR RE PRR CBRE 
if LTen(dict data) > 0: 
# key word = self.lineEdit.text () 
len _ index = len(dict data) 
list_target = [] # Mdict_data 中 提取 目标 数据 ， 基本 元 素 是 下 面 的 
dict_target 
for index in range(len index): 
dict temp = dict data[index]# 提取 从 服务 器 中 返回 的 其 中 一 行 信息 
dict_target = {} # 从 dict temp 中 提取 自己 需要 的 信息 ， 主 要 包括 标题 、 内 
容 、 时 间 、 下 载 URL 等 
' 提 取 标 题 与 内 容 ' 
_temp title = dict temp['announcementTitle'] 
_temp_ content = dict _temp['announcementContent'] 
for i in ['<em>', '</em>']: # <em>，</em> 是 服务 器 对 搜索 关键 词 添加 的 
标记 ， 这 里 对 它们 别 除 


temp title = temp title- replace (Tr T) 
Ltemp content = str( temp content) replace(i, "iy 
dict target ["trtle'] = temp title 
dict target content] > temp content 
' 提 取 时 间 ， 
_temp = Qict _temp['adjunctUrl'] 
dict _target['time'] = temp.split(r'/') [1] 
' 提 取 URL' 
基本 
download_url = 'http://www.cninfo.com.cn/cninfo-new/disclosure/ 


fulltext/download/{}?announceTime={}'.format ( 
ia, drot target Erme") 
dict target['download url'] = download url 
dict target['flag'] = flag 
# print (download url) 
' 添 加 处 理 的 结果 ' 
list_target.append(dict_ target) 





同样 ， 对 于 下 载 过 滤 ， 也 放 在 “ 目 定义 过 小 ”部 分 进行 讲解 。 
# 此 处 位 置 在 函数 show tablewidget 内 部 


' "根据 过 滤 规 则 进行 自 定义 过 滤 ， 黑 认 是 不 过 滤 的 '' 

df = DataFrame (list target) 

df Sole ofriiter df (dri ete title als G— Solem teen 
Hirie Mist Iter IContent Mist So Cieer Content ASE) 


‘tee, Æ list_target''' 
_temp = df.to dict ('index") 
list target = list(_temp.values ()) 


else: # ' 处 理 没 有 数据 的 情况 ' 
list target = i] 








获取 完 数 据 之 后 ， 接 下 来 显示 这 些 数据 。 首 移 确 定 需要 显示 数据 的 
行 数 、 列 数 ， 以 及 每 行 的 名 称 、 每 列 的 名 称 。 


# 此 处 位 置 在 函数 show tablewidget 内 部 


'''tableWidget 的 初始 化 ''' 
igst Col, = [En 4, Verte, "download uri™] 
len col = len(list_col) 
len index = len(list_target) # list target 可 能 有 所 改变 ， 需 要 重新 计算 长 度 
if tableWidget.objectName() == 'tableWidget title' 
selt list target tiele = List Itarget 


else: 


self.list target content = list target 

tableWidget.setRowCount (len index) # 设置 行 数 

tableWidget.setColumnCount (len col) # 设置 列 数 

tableWidget.setHorizontalHeaderLabels(['HI)', ' 标 题 '，' 查 看 ']) # RARE 
直方 向 上 的 名 称 

tableWidget.setVerticalHeaderLabels([str(i) for i in range(1, len Index 
+ 1)]) # 设置 水 平方 向 上 的 名 称 

tableWidget.setCornerButtonEnabled(True) # 点 击 左 上 角 进 行 全 选 





现在 对 每 行 和 每 列 填充 数据 。 


# 此 处 位 置 在 函数 show tablewidget 内 部 


"IHR tableWidget 的 数据 ''' 


for index in range(len index): 
for col in range (len col): 
name col = list col[col] 
1£ name col == ‘download url: 
item = QTableWidgetItem('#A') 
item.setTextAlignment (Qt.AlignCenter) 
font = QFont () 
font.setBold (True) 
font.setWeight (75) 
item.setFont (font) 
item.setBackground(QColor(218, 218, 218)) 
item.setFlags (Qt.ItemIsUserCheckable | Qt.ItemIsEnabled) 
tableWidget.setItem(index, col, item) 
elif name col == 'time': 
item = QTableWidgetItem(list target [index] [name_col]) 
item.setFlags(Qt.ItemIsUserCheckable | 
Ot.ItemIsEnabled) 
' "查看 当前 行 的 内 容 是 否 已 经 在 下 载 购物 车 中 ， 如 果 在 就 设置 为 选中 ' 
if list_target[index] in self. download info list: 
item.setCheckState (Qt.Checked) 
else: 
item.setCheckState (Qt.Unchecked) 
tableWidget.setItem(index, col, item) 
else: 
tableWidget.setItem(index, col, 
QTableWidgetItem(list target [index] [name _col])) 
# tableWidget.resizeColumnsToContents () 
tableWidget.setColumnWidth(1, 500) 


结合 结果 进行 解读 效果 会 更 好 ， 如 图 11-19 所 示 。 


国 券商 报告 获取 系统 











| 中 国 中 车 || em ER 
标题 搜索 。 内 容 搜索 
时 间 标题 查看 ^ 
1 O 2017-05-23 ”中 国 中 车 : 第 一 届 董 事 会 第 二 十 三 次 会 议决 议 公 告 查看 
2 口 2017-05-23 。 中 国 中 车 : 第 一 届 董 事 会 第 二 十 三 次 会 议决 议 公告 查看 
3 口 | | 中 国 中 车 : 独立 莉 事 关于 有 关 事项 的 独立 意见 查看 
a 口 2017-05-18 。 中 国 中 车 : 2016 年 公司 合 券 (第 一 期 ) 中 只 评级 报告 (2017) s5 
5 0217-05-13 ”中 国 中 车 : 关于 “13 南 车 01”、“13 南 车 02”\、“16 中 车 01 ”跟踪 评级 结果 的 公告 查看 
6 癌 2017-05-18 ”中国 中 车 : 13 南 车 01 、13 南 车 02 公 司 债券 跟踪 评级 报告 (2017) 查看 
7 O 2017-05-17 中 国 中 车 : 海外 监管 公告 - 13 南车 01 13 南车 02 公司 债券 跟踪 评级 报告 (2017) 查看 


8 癌 2017-05-17 中国 中 车 : 海外 监管 公告 - 2016 年 公司 债券 《第 一 期 ) 跟踪 评级 报告 (2017) 查看 
9 OJ 2017-05-17 eke 海外 上 监管 公告 ap zt M13 南车 011 ~ n3 B#02) ~a M16 中 车 011 跟踪 评 象 结 查看 





10 O 2017-05-11 AARE: 关于 子 公司 认购 北京 中 车 世纪 二 期 股权 投资 基金 《有 限 合伙 ) 份额 的 公告 查看 
1 口 2017-05-10 ARRE: BETAS ~ 关 认 子 公司 认购 北京 中 车 世纪 二 期 股权 投资 基金 《有限 合 移 ) 份 查看 
12 O 2017-05-04 ”中 国 中 车 : 非 登 记 股东 通知 信函 及 更 改 指示 回 条 查看 
13 O 2017-05-04 。 中 国 中 车 : GBR 查看 
14 O 2017-05-04 。 中 国 中 车 : 登记 股东 通知 信函 及 更 改 指示 回 条 查看 
15 口 2017-05-04 AHE: 委任 代表 表格 查看 v 
上 -页 1776 TA | | mm 口 选择 当 页 TRA 
图 11-19 


(1) 为 什么 右 侧 的 “ 碍 看 ?不 使 用 QPushButton 而 使 用 
QTableWidgetItem? 这 是 因为 如 果 使 用 QPushButton， 单 击 按钮 只 会 触 
发 QPushButton 的 信号 与 槽 机制 ， 而 且 会 完全 和 窗 新 tableWidget 的 信号 与 
槽 机 制 ， 因 此 tableWidget 的 信号 与 槽 机 制 不 会 被 触发 ， 而 使 用 
QTableWidgetItem 则 没有 这 个 问题 ， 所 以 这 里 使 用 QTableWidgetItem。 

item=QTableWidgetItem(' 查 看 ') 
item.setTextAlignment(Qt.AlignCenter) 
font=QFont() 

font.setBold(True) 

font.setWeight(75) 





item.setFont(font) 

item.setBackground(QColor(218,218,218)) 

item.setFlags(Qt.ItemIsUserCheckable | Qt.ItemIsEnabled) 

tableWidget.setItem(index,col,item) 

(2) 使 用 QTableWidgetltemA Hy check ”功能 而 不 是 散 入 
CheckBox 控件 ， 也 是 这 个 原因 ， 注 意 下 面 开 启 check 功 能 的 方法 。 

(3) 对 于 表格 页 面 中 的 某 一 行 记录 ， 如 果 之 前 选中 过 ， 那 么 当下 
次 跳 转 到 这 个 页 面 时 ， 我 们 希望 能 够 自动 选中 它 。 代 码 如 下 : 

item=QTableWidgetItem(list_target[index][name_col]) 





item.setFlags(Qt.ItemIsUserCheckable | 
Qt.ItemIsEnabled) 
"查看 当前 行 所 代表 的 内 容 是 否 已 经 在 下 载 购物 车 里 面 ， 如 果 在 
就 设置 为 选中 " 
if list_target[index]in self.download_info_list: 
item.setCheckState(Qt.Checked) 
else: 
item.setCheckState(Qt. Unchecked) 
tableWidget.setItem(index,col,item) 
(4) 可 以 指定 第 二 列 的 宽度 为 
500 (tableWidget.setColumnWidth(1,500)) ， 也 可 以 根据 列 的 内 容 长 度 
自动 调整 列 的 宽度 (tableWidget.resizeColumnsToContents()) 。 
# tableWidget.resizeColumnsToContents() 
tableWidget.setColumnWidth(1,500) 
4. 页 面 跳 转 
页 面 跳 转 要 实现 的 是 如 图 11-20 所 示 的 这 几 个 控件 的 功能 。 
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图 11-20 


首先 ， 我 们 从 _init 函数 中 的 信和 号 与 槽 出 发 ， 碍 看 程序 的 实现 方 
Bates 
页 面 跳 转 函数 ' 
self.pushButton_title_down.clicked.connect(lambda: 
self.page_go(‘title_down’)) 
self.pushButton_content_down.clicked.connect(lambda: 
self.page_go(‘content_down')) 
self.pushButton_title_up.clicked.connect(lambda: 
self.page_go(‘title_up')) 
self.pushButton_content_up.clicked.connect(lambda: 
self.page_go(‘content_up’')) 
self.pushButton_title_jump_to.clicked.connect(lambda: 
self.page_go(‘title_jump_to')) 
self.pushButton_content_jump_to.clicked.connect(lambda: 
self.page_go(‘content_jump_to')) 
可 以 看 到 ， 所 有 的 页 面 跳 转 函 数 都 指向 了 page_go 这 个 函数 ， 而 且 
此 处 使 用 的 是 可 以 传递 参数 的 信号 与 槽 机 制 。 
另外 ， 在 lineEdit 中 按 下 Enter 键 ， 所 呈现 的 效果 与 单 击 “ 页 面 跳 
转 ” 按 钮 一 样 。 
self.lineEdit_content_page.returnPressed.connect(self.pushButton_c 
ent_jump_to.click) 
self.lineEdit_title_page.returnPressed.connect(lambda: 


self.page_go(‘title_jump_to')) 


注意 

这 里 使 用 两 种 实现 方法 ， 其 中 一 种 方法 是 通过 触发 < 页 面 跳 转 ” 按 钮 
来 间接 触发 page_go 函数 ;， 男 一 种 方法 是 直接 触发 page_go 函数 。 这 两 
种 实现 方法 的 结果 是 一 样 的 。 

接 下 来 看 page_go 函 数 做 了 什么 工作 。 





def page go(self, go type): 


"OR DME BR"! 
if go_ type == 'title down': # EA T-N pA 


_temp = selfi.current page num title 
selt- Current page num EE += Ab 
if 1 <= self.current_page_num title <= self.total pages title: # 
如 果 待 跳 转 的 页 面 真 实 、 有 效 ， 则 继续 ; 否则 不 进行 跳 转 
self.update tablewidget title(page num=self.current_ 
page num title) 
else 
SSTt Coreen page mum anit Ley en 





当 在 标题 搜索 页 面 中 单 击 “ 下 一 页 ”按钮 时 ， 会 触及 page_go 函数 ， 
并 传递 title down 参数。 上 面 代码 的 作用 是 : 在 下 一 页 是 有 效 的 ， 则 进 
行 跳 转 ， 否 则 ， 不 进行 跳 转 。 
对 于 页 码 的 跳 转 ， 其 实现 方式 也 是 一 样 的 : 大 待 跳 转 的 页 人 码 是 有 效 
的 《就 是 珊 跳 转 的 页 码 PageNum 的 大 小 在 1 与 页 但 最 大 值 之 间 ) ， 则 进 
行 跳 转 ， 否 则 ， 不 进行 跳 转 。 
# 此 处 位 置 在 page_go 消 数 内 部 
elif go_type=='title_jump_to': 
_temp=self.current page_num_title 
self.current_page_num_title=int(self.lineEdit_title_page.text()) 














if 1 < =self.current_page_num_title < =self.total_pages_title: 
self.update_tablewidget_title(page_num=self.current_ 


page_num_title) 


else: 
self.current_page_num_title=_temp 
5. 快 速 选 择 
快速 选择 解决 的 是 图 11-21 所 示 的 黑色 框 中 选项 的 选择 问题 。 









标题 搜索 ABE 
时 间 标题 BE ^ 
if 口 2017-04-27 是 中 国 中 车 : 海外 监管 公告 - 第 一 届 莹 事 会 二 十 二 次 会 议 块 议 公告 查看 
2 中 国 中 车 : 海外 监管 公告 - 关於 公司 及 其 下 属 子 公司 对 外 担保 的 公告 查看 
3f O 2017-04-28 是 中 国 中 车 : 关于 13 南 车 01 、13 南 车 02、16 中 车 01 受 托管 理事 务 报告 《2016 年度) 查看 
| 页 面 跳 转 口 选择 当 页 下 载 所 选 
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图 11-21 





相关 的 信和 号 与 模 的 代码 如 下 ， 其 中 前 两 行 代 码 由 tableWidget 的 信和 号 
触发 ， 后 两 行 代码 由 checkBox 控 件 的 信号 触发 。 


"tableWidget 相 关 ' 
self.tableWidget title.itemChanged.connect(self.select_item) 


self.tableWidget_content.itemChanged.connect(self.select_item) 
选择 标题 或 者 内 容 ' 

self.checkBox_select_title.clicked["bool'] 
connect(self.select_checkBox) 
self.checkBox_select_content.clicked['bool']. 


connect(self.select_checkBox) 


PIC Mselect_item Ph BUT SA MATE, Ee CAE AS HE FE PR BL 


def Ise lect itemise l Gr artem): 
(gb Pea item 的 主 函 数 ! 7 


# print ('itemt+change') 


column = item.column () 
row = item.row() 
if column == 0: 只 针对 第 一 列 
if item.checkState() == Qt.Checked: 
if item.tableWidget().objectName() == 'tableWidget title': 


download one = self.list target _title[row] 
else: 
download_one = self.list_target_content [row] 
if download one not in self: download info list: 
self.download info list.append(download_ one) 
self.signal status.emit ("select status', []) 
else: 
if item.tableWidget() .objectName() == 'tableWidget title': 
download_one = self.list target _title[row] 
else: 
download one = self.list target content [row] 
if download one in self.download_ info list: 
self.download info list.remove (download one) 


self.signal statys- -emit ("select status). [])}) 





上 面 代码 的 意思 是 : 如 果 第 一 列 〈column=0) 的 item.checkState 为 
选中 状态 ， 则 从 当前 表格 中 找 出 当前 行 的 信息 ， 大 信息 不 在 下 载 购 物 车 
(self.download_info_list) 中 ， 则 添加 进去 ， 同 时 在 状态 栏 上 显示 
select_status 消 息 ; 若 item.checkState 为 不 选中 状态 ， 则 从 当前 表格 中 找 
出 当前 行 的 信息 ， 知 信息 在 下 载 购物 车 (self.download_info_list) 中 ， 
则 需要 把 信息 删除 ， 同 时 在 状态 栏 上 显示 select_status 消 息 。 

需要 说 明 的 是 ，self.signal_status.emit(select_status',[) 函 数 有 一 个 空 
列表 参数 ， 用 来 癌 状 态 栏 发 送 额外 的 信息 。 这 里 不 需要 额外 的 信息 ， 所 
以 传递 一 个 空 列表 就 行 了 ， 但 是 不 能 省 略 。 当 单 击 “ 下 载 所 选 ?按钮 后 ， 
将 会 触发 下 面 的 函数 。 

def select_checkBox(self,bool): 











sender=self.sender() # sender() 返 回 的 是 触发 了 这 个 信号 的 哪个 


if sender.objectName()=='checkBox_select_title': 
self.select_checkBox_one(sender,self.tableWidget_title) 
elif sender.objectName()=='checkBox_select_content': 


self.select_checkBox_one(sender,self.tableWidget_content) 


然后 调用 下 面 的 函数 。 


def select checkBox one(self, sender, tableWidget) : 
if sender.checkState() == Qt.Checked: 

self.select_tableWidget (tableWidget) 

if tableWidget.objectName() == 'tableWidget_title': 
selt select title page nto add(selt current 

page_num title) 

elif tableWidget.objectName() == 'tableWidget content': 

self.select content page info.add(self.current_ 


page num content) 


else: 
self.select_tableWidget clear (tableWidget) 
if tableWidget.objectName() == 'tableWidget title’: 


in selt current page num Erte an 


self.select title page info: 





self.select title page info.remove 





(self.current page num title) 
elif tableWidget.objectName() == 'tableWidget content': 
if self.current_ page num content in 
self.select content page info: 
self select content page info.remove 


(self.current_ page num content) 


上 面 代 人 码 的 意思 是 : 如 果 “ 选 择 当 页 ”的 checkBox 处 于 选中 状态 ， 
则 会 触发 self.select_tableWidget(tableWidget) 函 数 全 选 当前 列表 的 所 有 内 
容 ， 并 对 当前 页 面 已 经 选中 做 标记 ; 否则 ， 会 触发 
self.select_tableWidget_clear(tableWidget) 函 数 不 选 择 当前 列表 的 所 有 内 
容 ， 如 果 标 记 了 “选择 当 页 ” 则 删除 标记 。 这 里 之 所 以 要 进行 标记 和 删除 











标记 ， 是 为 了 方便 在 页 面 跳 转 时 上 自动 帮助 用 户 选 中 已 经 标记 的 页 面 ， 详 
见 前 面 的 show_tablewidget 函 数 。 
可 以 看 到 ， 下 面 的 两 个 函数 是 核心 ， 其 内 容 也 非常 简单 。 
def select_tableWidget(self,tableWidget): 
"选择 tableWidget 的 函数 " 


row_count=tableWidget.rowCount() 





for index in range(row_count): 
item=tableWidget.item(index,0) 
if item.checkState()==Qt.Unchecked: 
item.setCheckState(Qt.Checked) 
def select_tableWidget_clear(self,tableWidget): 
"ÄR PEtablewWidget Hyi R Bc" 
row_count=tableWidget.rowCount() 
for index in range(row_count): 
item=tableWidget.item(index,0) 
if item.checkState()==Qt.Checked: 
item.setCheckState(Qt. Unchecked) 
6. 下 载 所 选 
当选 择 好 之 后 ， 接 下 来 就 要 进行 下 载 了 ， 毕 竟 下 载 才 是 我 们 的 目 
的 。“ 下 载 所 选 ? 昌 然 只 是 一 个 按钮 ， 但 是 真正 实现 起 来 却 不 太 容 易 ， 因 
为 用 户 布 望 在 下 载 时 ， 既 可 以 知道 下 载 的 进度 ， 又 可 以 使 用 软件 进行 新 
的 搜索 。 这 就 产生 了 两 个 问题 : 
o PyQt 的 多 线程 问题 〈 这 里 指 主线 程 负 责 前 端的 使 用 ， 子 线程 负责 
后 端的 下 载 ) 。 
o PyQt 的 子 线程 与 主线 程 进行 交互 的 问题 (这 里 指使 用 子 线程 修改 
主线 程 的 状态 栏 的 显示 结果 ) o 
在 Python 中 ， 解 决 多 线程 问题 的 方法 有 很 多 ， 但 是 如 有 果 需 要 实现 子 

















线程 加 主线 程 发 射 信号 的 话 ， 那 么 就 只 能 使 用 PyQt 的 多 线程 技术 了 。 
原因 是 Python 的 多 线程 如 threading 不 能 实现 信号 的 发 射 ， 因 此 就 不 能 与 
改变 状态 栏 的 权 函 数 进行 连接 ;而 使 用 PyQt 的 QThread 则 不 存在 这 个 问 
题 。 
首先 从 init 函数 中 的 信号 与 档 开始 。 
“Ray! 
self.pushButton_download_select_title.clicked. 
connect(self.download_pdf) 
self.pushButton_download_select_content.clicked. 
connect(self.download_pdf) 
download_thread.signal.connect(self.show_status) # 连接 子 线程 的 
aS SERENE 
download _ thread 是 workThread 类 的 实例 ， 专 门 用 来 下 载 数据 。 对 于 
WorkThread 的 用 法 ， 稍 后 再 进行 说 明 。 这 里 的 
download_ thread.signal.connect(self.show_status) 函 数 的 意思 是 将 子 线程 的 
目 定义 信号 signal 与 主线 程 的 槽 函数 show_status 连 接 ， 这 样 束 实现 了 子 
线程 与 主线 程 的 交互 。 此 外 ，self.download_pdf 是 最 关键 的 函数 ， 下 面 
对 其 进行 解读 。 
def download_pdf(self): 
"下 载 PDEF 的 主 函 数 " 
if download_thread.isRunning()==True: 
QMessageBox.warning(self,' 警告 !, 检 测 到 下 载 程序 正在 运 
行 ， 请 不 要 重复 运行 ,QMessageBox.Yes) 


return None 











download_thread.download_list=self.download_info_list.copy() 
download_thread.download_path=copy.copy(self.download_path) 
download_thread.start() 





首先 ， 检 测 这 个 子 线程 是 否 正 在 执行 下 载 操作 ， 如 果 是 的 话 则 不 进 
行 下 一 步 操 作 。 因 为 单 击 * 下 载 所 选 ” 按 钮 之 后 会 有 一 个 初始 化 的 时 间 ， 
用 户 可 能 在 这 段 时 间 里 连续 单 击 这 个 按钮 ， 这 样 做 可 以 防止 出 现 这 种 情 
况 。 

其 次 ， 回 download_thread 类 实例 传递 下 载 的 列表 和 下 载 路 径 参 数 。 

最 后 ， 局 动 download_ thread 的 下 载 函数 : download_thread.start()。 

下 面 重点 介绍 WorkThread 类 。 实 际 上 ，WorkThread 类 与 
threading.Thread 类 相 比 ， 仅 仅 是 多 出 了 一 个 信号。 


class WorkThread(QThread): 
# 声 明 一 个 包括 str Fe list 类 型 参数 的 信号 
Signal = pyqtSignal(str, list) 


det ant (Self): 
self.download list = self.download path = [] 
self- -download list err = i] 
self.filter content list = self.filter title list = [] 
super (WorkThread, self). init () 


def main download(self, download list, download path, 
download _status='download_ status'): 
count_all = len(download list) 


count err = count right = count num = 0 


self.download list err = [] 

for key dict in download list: 
count num += 1 
download Url = key dict['download_ url '] 
time = key dict["time"] 
title = key dict['title"] 
total title fame: se 1 M a ete 
total title total title replaces. Ns) ") 
total title total _title.replace('?', '? ") 
total title = total _title.replace('*', '*"') 


file path = download path + os.sep + 'ss.pdf' % total title 
if os.path.isfile(file path) == True: # 车 文件 已 经 存在 ， 则 默认 为 
下 载 成 功 
count right += 1 
Signal list = [count num, count all, count right, 
count err, title] 
self.signal.emit (download_status, signal list) # 循环 结束 


后 发 出 信号 
continue 
else: 
f = open(file path, "wb") # 先 建 立 一 个 文件 ， 以 免 其 他 线程 重复 
建立 这 个 文件 
try: 
r = requests.get (download url, stream=True) 
data = r.raw.read() 
except: 
self.download list err.append(key dict) 
count_err += 1 
£.close() 
os.remove(file path) # 文件 下 载 失败 ， 要 先 关闭 open HK, 
然后 删除 文件 


signal list = [count_num, count all, count right, 
count err, title] 
self.signal.emit (download status, signal list) # 循环 
结束 后 发 出 信号 
continue 
f.write (data) 
f.close() 
count right += 1 
signal list = [count num, count all, count right, 


count ore bel 


self.signal.emit (download_status, signal_list) # 循环 结 EK 


def run(self): 
self.main download (self.download list, self.download path, 
download_status='download_status') 
self.main_download(self.download list err, self. download path, 
download status='download status err") 
self.main_download(self.download list_err, self.download path, 


download_status='download_status_err') 


上 面 的 代码 并 不 难 理解 ， 但 是 有 三 点 需要 注意 。 
C1) 由 于 路 径 中 不 能 出 现 “:”“?”** 等 字符 ， 因 此 要 对 它们 进行 丛 








换 。 
download_url=key_dict['download_url'] 
time=key_dict['time'] 
title=key_dict['title’] 
total_title=time + '_' + title 
total_title=total_title.replace(':',': ') 
total_title=total_title.replace('?’,'? ') 
total_title=total_title.replace('*",'*') 

(2) 每 次 下 载 无 论 是 否 成 功 ， 都 要 回 主 程序 发 出 信号。 
signal_list=[count_num,count_all,count_right,count_err,title] 
self.signal.emit(download_status,signal_list) # 循环 结束 后 发 出 信和 号 

signal_list 是 传递 的 额外 的 信号 ， 可 以 在 主线 程 的 show_status 函数 
中 碍 看 它 的 使 用 方法 。 








def show status(self, type, list args): 
if type == 'download status': 
count num, count all, count right, count err, title = list args 
self.statusBar().showMessage ( 
"52 {0}/{3}, LM: {1}, BR: {2}, RKER: 
{4}'.format (count_num, count right, Count err, count _all, title)) 
if. types == "download. status err.: 
count num; count arl, count Ergat, Cownt err, title = list args 
self.statusBar () .ShowMessage ( 
' 重 新 下 载 失败 : 完成 : {0}/{3}， 正确 :{1}， 错误 : {2}， 本 次 下 载 : 
(a format (count num, count right, Count err, count all, title)) 
if type == "select status": 
self.statusBar() .showMessage (' 已 选择 : %d' $ 
len(self.download info listy) 


if type == "change save path status": 


self.statusBar().showMessage ('4k#H REAA: Ss' % 
self.download path) 
if type == 'clear': 


self.statusBar().showMessage(' ') 

(3) 当 第 一 次 下 载 操作 运行 完毕 之 后 ， 可 能 会 有 一 些 漏网 之 鱼 
(因为 有 下 载 失败 被 忽略 的 情况 ) ， 解 决 方法 就 是 重复 两 次 下 载 失 败 的 
操作 。 一 般 情 况 下 ， 第 一 次 下 载 束 可 以 100% 成 功 ， 男 外 两 次 下 载 操作 
仅仅 是 多 加 一 层 保险 而 已 。 

def run(self): 


self.main_download(self.download_list,self.download_path, 











download_status='download_status') 
self.main_download(self.download_list_err,self.download_path,d 
self.main_download(self.download_list_err,self.download_path,d 
7. 碍 看 功能 
查看 功能 解决 的 是 单 击 如 图 11-22 所 示 的 “查看 ”按钮 ， 就 可 以 自动 
打开 相应 的 PDF 文 件 的 问题 。 





标题 搜索 ABBE 
时 间 标题 


2017-05-22 ABH: 海外 监管 公告 - 第 一 届 董 事 会 第 二 十 三 次 会 议决 议 公告 
2017-05-23 中国 中 车 : 第 一 届 董 事 会 第 二 十 三 次 会 议决 议 公告 

2017-05-23 中国 中 车 : 第 一 届 董 事 会 第 二 十 三 次 会 议决 议 公告 
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图 11-22 


这 部 分 内 容 很 简单 ， 首 先 从 _init 函数 的 信号 与 槽 开始 。 
self.tableWidget_title.cellClicked.connect(self.view_one_new) 
self.tableWidget_content.cellClicked.connect(self.view_one_new) 

可 以 看 到 ， 主 要 是 view_one_new 函 数 在 起 作用 。 
def view_one_new(self,row,column): 

"查看 新 闻 的 主 函数 " 
sender=self.sender() 
if column==2: # 只 针对 第 三 列 --- > 查看 
if sender.objectName()=='tableWidget_title': 
download_one=self.list_target_title[row] 
else: 
download_one=self.list_target_content[row] 
download_path=copy.copy(self.download_path) 
view_thread=threading.Thread(target=self.view_one_new_thread 
(download_path,download_one),daemon=True) 
view_thread.start() 
这 里 的 查看 功能 使 用 的 也 是 多 线程 ， 因 为 用 户 希 望 在 后 台 下 载 PDF 
文件 的 过 程 中 ， 不 影响 自己 对 软件 的 操作 。 由 于 这 里 的 子 线 程 与 主线 程 
不 进行 交互 ， 所 以 不 需要 使 用 QThread， 只 需 使 用 相对 简单 的 threading 





模块 就 可 以 了 。 


def view one new thread(self, download path, download one) : 
' "查看 功能 的 多 线程 程序 ' 
download_url = download _one['download_url"'] 
ttile = Uomoad onei! tatier] 
title = title. replace(" st; Ss S) 
title = title.replace('?', '? ') 
title = title .replace’*",. Ve") 


path = download path + os.sep + '"%s.pdf' $ title 
if not os.path.isfile(path): 
Cry: 
r = requests.get (download url, stream=True) 
data = r.raw.read() 
except: 
return 
f = open (path, "wb") 
f.write (data) 
fo close) 


os.system (path) 


子 线程 中 的 查看 功能 实现 起 来 很 简单 : 只 需要 将 相应 的 PDF 文档 下 
载 到 本 地 ， 然 后 用 系统 默认 的 PDF 查看 器 打开 即 可 。 打 开 PDF 文档 仅仅 
需要 如 下 一 行 代码 : 

os.system(path) 

8. 结 果 排 序 

有 时 候 用 户 可 能 需要 对 结果 进行 排序 处 理 ， 其 实质 就 是 模拟 网 页 的 
操作 ， 因 此 排序 方法 和 官网 的 排序 方法 一 致 ， 如 图 11-23 所 示 。 
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当选 择 “ 不 限 排序 ?选项 时 ， 会 触发 下 面 的 函数 。 


@pyqtSlot (bool) 
def on_checkBox sort flag _clicked(self, checked): 
if checked == True: # 恢复 默认 的 排序 
self.comboBox name.setEnabled (False) 


self.comboBox type.setEnabled (False) 


self sort name = nothing" 
Selt ort type = desc: 
elif self.comboBox_name.currentText() == ' 相 关 度 ': # 对 于 相关 度 ， 

有 些 特殊 

self.comboBox name.setEnabled (True) 

self.comboBox type.setEnabled(False) # 上 面 
comboBox_name.currentText ()==" 相 关 度 "， 则 这 个 控件 不 可 用 。 这 是 模拟 官网 的 操作 

self.sort name = 'nothing' 

sel. sore type desc: 


else: # 对 于 其 他 的 ， 则 设置 对 应 的 参数 


self.comboBox name.setEnabled (True) 





self.comboBox type.setEnabled (True) 
sort name = self.comboBox name.currentText () 


sort type = self.comboBox type.currentText () 


self.sort_ name = self.comboBox dict[sort_name] 


self.sort type = self.comboBox dict[sort_ type] 


上 面 代码 的 意思 是 : 如 果 不 需 要 对 结果 进行 排序 ， 则 设置 sort_name 
和 sort_type 为 默认 值 ， 耕 需要 排序 ， 则 : 

e 如 条 排序 名 称 选择 的 是 “相关 度 ”， 则 不 允许 选择 排序 名 称 〈 这 是 
模拟 官网 的 结果 ) o 

© 如 采 排 序 名称 没 有 选择 “相关 度 ”， 则 可 以 选择 排序 名 称 。 

排序 名 称 和 排序 类 型 两 个 comboBox 对 应 的 代码 如 下 ， 其 逻辑 同 
alive 


@pygqtSlot (str) 
def on _comboBox name currentTextChanged(self, p0): 
if pO == '"FAKR': 

self.comboBox_ name.setEnabled (True) 
self.comboBox type.setEnabled (False) 
self.sort name = "nothing' 
self .sort type = “desc* 

else: 
self .comboBox_name.setEnabled (True) 


self.comboBox_type.setEnabled (True) 


sort name = self.comboBox name.currentText () 


self.sört mame = Self combobox dictsonk name] 


@pyqtSlot (str) 
def on _comboBox type currentTextChanged(self, p0): 
sort type = self.comboBox type.currentText () 


self.sort_type = self.comboBox dict[sort_type] 


9. 时 间 过 小 
时 间 过 滤 功 能 相对 简单 ， 无 非 是 修改 传递 时 间 的 参数 。 
@pyadtSlot(QDate) 
def on_dateEdit_dateChanged(self,date): 
self.start_time=self.get_dateEdit_time(self.dateEdit) 
@pyadtSlot(QDate) 
def on_dateEdit_2_dateChanged(self,date): 
self.end_time=self.get_dateEdit_time(self.dateEdit_2) 
10. 自 定义 过 渡 
这 部 分 不 仅 实现 了 完整 的 模拟 官方 网 站 的 功能 ， 而 且 还 间接 地 实现 
了 对 官方 网 站 进行 自 定义 搜索 的 功能 。 用 户 可 以 通过 设置 关键 词 对 搜索 
结果 进行 自 定义 过 滤 。 首 先 看 GUI 的 呈现 ， 如 图 11-24 所 示 。 
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图 11-24 


当选 择 “ 过 滤 标 题 * 或 “过 滤 内 容 * 后 ， 对 应 的 lineEdit 束 会 设置 为 可 用 
状态 ， 这 时 如 果 鼠 标 指针 在 lineEdit 上 停留 一 会 儿 ， 则 会 出 现 如 图 11-24 
所 示 的 提示 框 ， 用 来 说 明 过 滤 搜 索 的 使 用 方法 。 这 个 提示 框 的 设计 通过 
Qt I 快捷 菜单 中 选 
择 “ 改 变 工具 提示 >”。 

PS init 函数 的 信号 与 槽 开始 分 析 这 部 分 内 容 。 

显示 /下 载 过 小 操作 


self.checkBox_filter_title.clicked['bool’].connect(self.filter_enable) 





self.checkBox_filter_content.clicked['bool'].connect(self.filter_enable) 


PJ iL, filter enable 函数 是 最 关键 的 。 


def filter_enable(self,bool): 
sender=self.sender() 
if sender.objectName()=='checkBox_filter_title’: 
if bool==True: 
self.lineEdit_filter_title.setEnabled(True) 
else: 
self.lineEdit_filter_title.setEnabled(False) 
elif sender.objectName()=='checkBox_filter_content': 
if bool==True: 
self.lineEdit_filter_content.setEnabled(True) 
else: 
self.lineEdit_filter_content.setEnabled(False) 
filter_enable 所 解决 的 问题 非常 简单 ， 以 “过 滤 标 题 ” 的 checkBox 为 
例 一 一 当选 择 “ 过 滤 标 题 ”* 的 checkBox 时 ， 对 应 的 lineEdit 就 设置 为 可 用 状 
态 ; 否则， 设置 为 不 可 用 状态 。 
接 下 来 对 show_tablewidget 函 数 中 的 过 滤 部 分 进行 解读 
"检测 过 滤 显 示 的 信息 " 
if self.lineEdit_filter_title.isEnabled()==True: 
filter_text=self.lineEdit_filter_title.text() 
self.filter_title_list=self.get_filter_list(filter_text) 
else: 
self.filter_title list=[] 
if self.lineEdit_filter_content.isEnabled()==True: 
filter_text=self.lineEdit_filter_content.text() 
self.filter_content_list=self.get_filter_list(filter_text) 
else: 


self.filter_content_list=[] 


如 果 启 用 了 lineEdit_filter_title 或 者 lineEdit_filter_content, A Ait 
从 中 选取 过 滤 的 信息 ; 否则 ， 融 设置 为 ] 〈 不 过 滤 ) 。 我 们 通过 
get_filter_list 对 所 选取 的 文本 信息 进行 进一步 加 工 ， 使 之 更 容易 被 处 
理 o 





def get_filter_list(self,filter_text): 
filter_text=re.sub(r'[\s() ©) T," filter_text) # 别 除 空 格 ，(，)， 
G ) ， 换 行 符 等 元 素 
filter_list=filter_text.split(’&') 
return filter_list 
以 传 入 的 关键 词 “ 中 国 & 中 车 区 (年 度 | 季度 )” 为 例 ， 这 里 的 小 括 
号 “0 仅仅 是 为 了 便于 理解 ， 没 有 其 他 的 意思 。 同 时 考 上 感到 用 户 也 可 能 
会 输入 全 角 状 态 下 的 小 括号 ” () ”和 空格 等 元 素 ， 因 此 要 删除 这 些 非 中 
文字 符 。 最 后 ， 所 传 入 的 关键 词 在 这 个 函数 中 会 返回 列表 :『 中 国 ', 中 
车 ,年 度 | 季度 ]。 接 下 来 它 会 被 派 上 用 场 。 
"根据 过 泪 规 则 进行 目 定 义 过 滤 ， 默 认 是 不 过 沽 " 
df=DataFrame(list_target) 

















df=self.filter_df(df,filter_title_list=self.filter_title_list,filter_content_li 
"过 滤 后 ， 更 新 list_target" 
_temp=df.to_dict(‘index’) 
list_target=list(_temp.values()) 
上 面 代码 的 意思 是 : 先 把 list_target 变 成 DataFrame， 然 后 对 
DataFrame 进 行 过 滤 ， 最 后 再 把 DataFrame 变 成 list_target。 在 这 里 过 滤 的 
主 函 数 是 filter df。 


def filter df(self, df, filter title list=[],filter content list=[]): 


过 滤 df 的 主子 数 
:param df: df.columns 
Ome rro: 
Inder([ "content"; "download ori', “Eime, TErtiei, 


dtype='object') 


:param filter title list: filter title list=A, FÆ F] 
filter_content_list: filter content List=[ 7" 成都" 年度 ' | ' FZ" ] 
人 七 可 下 2 ele filter 


for each im fitter titie list: 
ser = df.title 
df = df[ser.str.contains (each) } 


filter content list = [each + '|None' for each in filter content list] 
# 处 理 内 容 返回 为 None 的 情况 ， 作 用 是 若 没 有 文章 内 容 返 回 ， 则 不 进行 过 滤 


de Ln ee ls 


ser = df.content 
df = df[ser.str.contains (each) ] 


return df 


这 里 用 到 了 pandas 模块 的 一 些 基 本 技巧 。pandas 是 Python 在 处 理 
数据 方面 的 瑞士 军刀 级 别 的 模块 ， 根 据 笔者 的 经 验 ， 基 本 上 90% 以 上 的 
数据 处 理 任 务 pandas 都 能 够 胜任 ， 而 且 性 能 时 越 。 现 在 对 ser.str.contains 
函数 进行 简单 的 说 明 。pandas 对 字符 串 的 处 理 统一 封装 到 str 类 中 ， 
contains 接 受 的 参数 是 一 个 正则 表达 式 ， 因 此 “年 度 | 季度 ”表示 的 是 年 度 
或 季度 。ser.str.contains(" 年 度 | 季度 "返回 的 是 一 个 bool 类 型 的 
Series (pandas 中 非常 常用 的 一 个 类 ， 也 就 是 ser 实 例 化 的 类 )〉 ， 包 含 “ 年 
度 | 季度 ”的 为 True， 不 包含 的 为 False。 

#2 PK show_tablewidget ”函数 把 过 滤 后 的 list_target ”显示 到 
tableWidget 上 ， 在 下 载 时 也 会 进行 这 样 的 过 滤 。 

至 此 ， 本 书 最 后 一 个 案例 也 介绍 完毕 了 。 作 为 本 书 最 具有 实战 性 的 























案例 ， 可 以 看 出 ， 想 要 开发 出 一 个 具有 实用 价值 的 案例 是 一 个 很 复杂 的 
工程 ， 需 要 认真 处 理 各 方面 的 细节 。 同 时 ， 也 可 以 看 出 ，PyQt 仅 仅 是 一 
个 制作 GUI 的 工具 ， 对 于 底层 的 业务 逻辑 ， 则 需要 其 他 领域 的 技术 来 文 
撑 。 以 本 节 的 案例 为 例 ， 这 个 案例 所 涉及 的 不 仅仅 是 PyQt， 还 有 网 络 爬 
虫 技术 、 数 据 分 析 与 处 理 撤 术 以 及 多 线程 技术 等 。 因 此 ， 想 要 学 会 程序 
开发 ， 要 学 的 东西 不 仅仅 有 PyQt， 还 需要 读者 在 其 他 领域 中 不 断 探索 。 

路 漫漫 其 修 远 今 ， 君 将 上 下 而 求索 。 在 读者 的 不 断 求 索 中 ， 能 够 与 
本 书 相遇 也 是 一 种 缘分 ， 如 果 能 够 从 本 书 中 获取 目 己 想 要 的 东西 ， 那 惑 
是 笔者 最 大 的 欣慰 。 

最 后 ， 提 前 预 祝 读 者 学 习 上 轻松 愉快 、 工 作 上 更 进一步 、 生 活 上 至 
福美 满 。 
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